Java Doc for Heap.java in  » Database-DBMS » db-derby-10.2 » org » apache » derby » impl » store » access » heap » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This routine update's the in-memory object version of the Heap Conglomerate to have one more column of the type described by the input template column.

Manufacture a Heap Conglomerate out of "thin" air, to boot strap the system.

Create a heap conglomerate.

Returns true and fetches the rightmost row of an ordered conglomerate into "fetchRow" if there is at least one row in the conglomerate.

The dynamic info is a set of variables to be used in a given ScanController or ConglomerateController.

Will have to change when a conglomerate could have more than one container.

The static info would be valid until any ddl was executed on the conglomid, and would be up to the caller to throw away when that happened.

Return an open StoreCostController which can be used to ask about the estimated row counts and costs of ScanController and ConglomerateController operations, on the given conglomerate.

Parameters:
  xact_manager - The TransactionController under which this operation takes place.
Parameters:
  rawtran - raw transaction context in which scan is managed.

This routine update's the in-memory object version of the Heap Conglomerate to have one more column of the type described by the input template column.
Parameters:
  column_id - The column number to add this column at.
Parameters:
  template_column - An instance of the column to be added to table.
exception:
  StandardException - Standard exception policy.

Manufacture a Heap Conglomerate out of "thin" air, to boot strap the system. Create an in-memory Heap Conglomerate with the input parameters, The caller will use this to open the conglomerate conglomerate and read the "real" values from disk. Conglom-conglom is always on segment 0.
Parameters:
  containerid - The container id of the conglomerate.
Parameters:
  template - Object array describing the columns of the heap.

Create a heap conglomerate. This method is called from the heap factory to create a new instance of a heap.

exception:
  StandardException - Standard exception policy.

See Also:   Conglomerate.defragmentConglomerate
exception:
  StandardException - Standard exception policy.

Returns true and fetches the rightmost row of an ordered conglomerate into "fetchRow" if there is at least one row in the conglomerate. If there are no rows in the conglomerate it returns false.

Non-ordered conglomerates will not implement this interface, calls will generate a StandardException.

RESOLVE - this interface is temporary, long term equivalent (and more) functionality will be provided by the openBackwardScan() interface.
Parameters:
  conglomId - The identifier of the conglomerateto open the scan for.
Parameters:
  open_mode - Specifiy flags to control opening of table. OPENMODE_FORUPDATE - if set open the table forupdate otherwise open table shared.
Parameters:
  lock_level - One of (MODE_TABLE, MODE_RECORD, or MODE_NONE).
Parameters:
  isolation_level - The isolation level to lock the conglomerate at.One of (ISOLATION_READ_COMMITTED or ISOLATION_SERIALIZABLE).
Parameters:
  scanColumnList - A description of which columns to return from every fetch in the scan. template, and scanColumnList work togetherto describe the row to be returned by the scan - see RowUtil for description of how these three parameters work together to describe a "row".
Parameters:
  fetchRow - The row to retrieve the maximum value into. boolean indicating if a row was found and retrieved or not.
exception:
  StandardException - Standard exception policy.

For heap just return "this", which both implements Conglomerate and StaticCompiledOpenConglomInfo.

this

The dynamic info is a set of variables to be used in a given ScanController or ConglomerateController. It can only be used in one controller at a time. It is up to the caller to insure the correct thread access to this info. The type of info in this is a scratch template for btree traversal, other scratch variables for qualifier evaluation, ...

The dynamic information.
Parameters:
  conglomId - The identifier of the conglomerate to open.
exception:
  StandardException - Standard exception policy.

Will have to change when a conglomerate could have more than one container. The ContainerKey is a combination of the container id and segment id. The ContainerKey.

The static info would be valid until any ddl was executed on the conglomid, and would be up to the caller to throw away when that happened. This ties in with what language already does for other invalidation of static info. The type of info in this would be containerid and array of format id's from which templates can be created. The info in this object is read only and can be shared among as many threads as necessary.

The static compiled information.
Parameters:
  conglomId - The identifier of the conglomerate to open.
exception:
  StandardException - Standard exception policy.

whether conglomerate is temporary or not.

See Also:   Conglomerate.load
exception:
  StandardException - Standard exception policy.

See Also:   Conglomerate.open
exception:
  StandardException - Standard exception policy.

See Also:   Conglomerate.openScan
exception:
  StandardException - Standard exception policy.

Return an open StoreCostController which can be used to ask about the estimated row counts and costs of ScanController and ConglomerateController operations, on the given conglomerate.

Parameters:
  xact_manager - The TransactionController under which this operation takes place.
Parameters:
  rawtran - raw transaction context in which scan is managed. The open StoreCostController.
exception:
  StandardException - Standard exception policy.
See Also:   StoreCostController