MethodFactory
, ModuleSupportable
B2IFactory
, HeapConglomerateFactory
public interface ConglomerateFactory extends MethodFactory
Modifier and Type | Field | Description |
---|---|---|
static int |
BTREE_FACTORY_ID |
|
static int |
HEAP_FACTORY_ID |
MODULE
Modifier and Type | Method | Description |
---|---|---|
Conglomerate |
createConglomerate(TransactionManager xact_mgr,
int segment,
long input_containerid,
DataValueDescriptor[] template,
ColumnOrdering[] columnOrder,
int[] collationIds,
java.util.Properties properties,
int temporaryFlag) |
Create the conglomerate and return a conglomerate object
for it.
|
int |
getConglomerateFactoryId() |
Return the conglomerate factory id.
|
void |
insertUndoNotify(AccessFactory access_factory,
Transaction xact,
PageKey page_key) |
Interface to be called when an undo of an insert is processed.
|
Conglomerate |
readConglomerate(TransactionManager xact_mgr,
ContainerKey container_key) |
Return Conglomerate object for conglomerate with container_key.
|
defaultProperties, primaryFormat, primaryImplementationType, supportsFormat, supportsImplementation
canSupport
static final int HEAP_FACTORY_ID
static final int BTREE_FACTORY_ID
int getConglomerateFactoryId()
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? ).
Conglomerate createConglomerate(TransactionManager xact_mgr, int segment, long input_containerid, DataValueDescriptor[] template, ColumnOrdering[] columnOrder, int[] collationIds, java.util.Properties properties, int temporaryFlag) throws StandardException
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 creationcollationIds
- collation ids of columns in the conglomerate.properties
- Properties associated with the conglomerate.StandardException
- if the conglomerate could not be
opened for some reason, or if an error occurred in one of
the lower level modules.Conglomerate readConglomerate(TransactionManager xact_mgr, ContainerKey container_key) throws StandardException
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.
xact_mgr
- transaction to perform the create in.container_key
- The unique id of the existing conglomerate.StandardException
- Standard exception policy.void insertUndoNotify(AccessFactory access_factory, Transaction xact, PageKey page_key) throws StandardException
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.
access_factory
- current access_factory of the aborted insert.xact
- transaction that is being backed out.page_key
- page key of the aborted insert.StandardException
- Standard exception policy.Apache Derby V10.14 Internals - Copyright © 2004,2018 The Apache Software Foundation. All Rights Reserved.