Interface ConglomerateFactory

    • Method Detail

      • getConglomerateFactoryId

        int getConglomerateFactoryId()
        Return the conglomerate factory id.

        Return a number in the range of 0-15 which identifies this factory. Code which names conglomerates depends on this range currently, but could be easily changed to handle larger ranges. One hex digit seemed reasonable for the number of conglomerate types currently implemented (heap, btree) and those that might be implemented in the future: gist, gist btree, gist rtree, hash, others? ).

        Returns:
        an unique identifier used to the factory into the conglomid.
      • createConglomerate

        Conglomerate createConglomerate​(TransactionManager xact_mgr,
                                        int segment,
                                        long input_containerid,
                                        DataValueDescriptor[] template,
                                        ColumnOrdering[] columnOrder,
                                        int[] collationIds,
                                        java.util.Properties properties,
                                        int temporaryFlag)
                                 throws StandardException
        Create the conglomerate and return a conglomerate object for it. It is expected that the caller of this method will place the the resulting object in the conglomerate directory.
        Parameters:
        xact_mgr - transaction to perform the create in.
        segment - segment to create the conglomerate in.
        input_containerid - containerid to assign the container, or ContainerHandle.DEFAULT_ASSIGN_ID if you want raw store to assign an id.
        template - Template of row in the conglomerate.
        columnOrder - columns sort order for Index creation
        collationIds - collation ids of columns in the conglomerate.
        properties - Properties associated with the conglomerate.
        Throws:
        StandardException - if the conglomerate could not be opened for some reason, or if an error occurred in one of the lower level modules.
      • readConglomerate

        Conglomerate readConglomerate​(TransactionManager xact_mgr,
                                      ContainerKey container_key)
                               throws StandardException
        Return Conglomerate object for conglomerate with container_key.

        Return the Conglomerate Object. This is implementation specific. Examples of what will be done is using the key to find the file where the conglomerate is located, and then executing implementation specific code to instantiate an object from reading a "special" row from a known location in the file. In the btree case the btree conglomerate is stored as a column in the control row on the root page.

        This operation is costly so it is likely an implementation using this will cache the conglomerate row in memory so that subsequent accesses need not perform this operation.

        Parameters:
        xact_mgr - transaction to perform the create in.
        container_key - The unique id of the existing conglomerate.
        Returns:
        An instance of the conglomerate.
        Throws:
        StandardException - Standard exception policy.
      • insertUndoNotify

        void insertUndoNotify​(AccessFactory access_factory,
                              Transaction xact,
                              PageKey page_key)
                       throws StandardException
        Interface to be called when an undo of an insert is processed.

        Implementer of this class provides interface to be called by the raw store when an undo of an insert is processed. Initial implementation will be by Access layer to queue space reclaiming events if necessary when a rows is logically "deleted" as part of undo of the original insert. This undo can happen a lot for many applications if they generate expected and handled duplicate key errors.

        Caller may decide to call or not based on deleted row count of the page, or if overflow rows/columns are present.

        Parameters:
        access_factory - current access_factory of the aborted insert.
        xact - transaction that is being backed out.
        page_key - page key of the aborted insert.
        Throws:
        StandardException - Standard exception policy.