Apache Derby Database Engine and Embedded JDBC Driver 10.17.1.0 · org.apache.derby.impl.sql.execute.TemporaryRowHolderImpl

Modifier and Type	Field and Description
pack-priv Activation	activation Activation object with local state information.
private ConglomerateController	cc
private long	CID
private boolean	conglomCreated
public static final int	DEFAULT_OVERFLOWTHRESHOLD
private RowLocation	destRowLocation
private boolean	isUniqueStream
private boolean	isVirtualMemHeap
protected int	lastArraySlot
private int	numRowsIn
private SQLLongint	position_sqllong
private ConglomerateController	positionIndex_cc
private long	positionIndexConglomId
private boolean	positionIndexCreated
private DataValueDescriptor[]	positionIndexRow
private Properties	properties
private ResultDescription	resultDescription
protected ExecRow[]	rowArray
private ScanController	scan
protected int	state
protected static final int	STATE_DRAIN
protected static final int	STATE_INSERT
protected static final int	STATE_UNINIT
private ConglomerateController	uniqueIndex_cc
private long	uniqueIndexConglomId
private boolean	uniqueIndexCreated
private DataValueDescriptor[]	uniqueIndexRow

Constructor Summary

Access	Constructor and Description
public	TemporaryRowHolderImpl(Activation the activation activation, Properties the properties of the original table. Used to help the store use optimal page size, etc. properties, ResultDescription the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null resultDescription) Uses the default overflow to a conglomerate threshold (5).
public	TemporaryRowHolderImpl(Activation the activation activation, Properties the properties of the original table. Used to help the store use optimal page size, etc. properties, ResultDescription the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null resultDescription, boolean - true , if it has to be temporary row holder unique stream isUniqueStream) Uses the default overflow to a conglomerate threshold (5).
public	TemporaryRowHolderImpl(Activation the activation activation, Properties the properties of the original table. Used to help the store use optimal page size, etc. properties, ResultDescription the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null resultDescription, int on an attempt to insert this number of rows, the rows will be put into a temporary conglomerate. overflowToConglomThreshold, boolean isUniqueStream, boolean isVirtualMemHeap) Create a temporary row holder with the defined overflow to conglom

Method Summary

Modifier and Type	Method and Description
private ExecRow	cloneRow(ExecRow inputRow)
public void	close() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.close. Clean up
public long	getPositionIndexConglomId() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getPositionIndexConglomId.
public CursorResultSet	Returns: a result set to use getResultSet() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getResultSet. Get a result set for scanning what has been inserted so far.
public long	Returns: Conglomerate ID of temporary conglomerate getTemporaryConglomId() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getTemporaryConglomId. Accessor to get the id of the temporary conglomerate.
public void	insert(ExecRow the row to insert inputRow) Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.insert. Insert a row
private void	insertToPositionIndex(int - the number of the row we are inserting into heap position, RowLocation the row to Location in the temporary heap rl) Maintain an index that will allow us to read from the temporary heap in the order we inserted.
private boolean	isRowAlreadyExist(ExecRow the row we are inserting to temporary row holder inputRow) Maintain an unique index based on the input row's row location in the base table, this index make sures that we don't insert duplicate rows into the temporary heap.
private Properties	makeIndexProperties(DataValueDescriptor[] indexRowArray, long conglomId)
private DataValueDescriptor[]	makeTemplateRow(DataValueDescriptor[] The original row originalRow) Make a template row for creating the spillover conglomerate.
public void	setRowHolderTypeToUniqueStream() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.setRowHolderTypeToUniqueStream.
public void	truncate() Purge the row holder of all its rows.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

activation	back to summary
pack-priv Activation activation Activation object with local state information.

cc	back to summary
private ConglomerateController cc

CID	back to summary
private long CID

conglomCreated	back to summary
private boolean conglomCreated

DEFAULT_OVERFLOWTHRESHOLD	back to summary
public static final int DEFAULT_OVERFLOWTHRESHOLD

destRowLocation	back to summary
private RowLocation destRowLocation

isUniqueStream	back to summary
private boolean isUniqueStream

isVirtualMemHeap	back to summary
private boolean isVirtualMemHeap

lastArraySlot	back to summary
protected int lastArraySlot

numRowsIn	back to summary
private int numRowsIn

position_sqllong	back to summary
private SQLLongint position_sqllong

positionIndex_cc	back to summary
private ConglomerateController positionIndex_cc

positionIndexConglomId	back to summary
private long positionIndexConglomId

positionIndexCreated	back to summary
private boolean positionIndexCreated

positionIndexRow	back to summary
private DataValueDescriptor[] positionIndexRow

properties	back to summary
private Properties properties

resultDescription	back to summary
private ResultDescription resultDescription

rowArray	back to summary
protected ExecRow[] rowArray

scan	back to summary
private ScanController scan

state	back to summary
protected int state

STATE_DRAIN	back to summary
protected static final int STATE_DRAIN

STATE_INSERT	back to summary
protected static final int STATE_INSERT

STATE_UNINIT	back to summary
protected static final int STATE_UNINIT

uniqueIndex_cc	back to summary
private ConglomerateController uniqueIndex_cc

uniqueIndexConglomId	back to summary
private long uniqueIndexConglomId

uniqueIndexCreated	back to summary
private boolean uniqueIndexCreated

uniqueIndexRow	back to summary
private DataValueDescriptor[] uniqueIndexRow

Constructor Detail

TemporaryRowHolderImpl	back to summary
public TemporaryRowHolderImpl(Activation activation, Properties properties, ResultDescription resultDescription) Uses the default overflow to a conglomerate threshold (5). Parameters activation:Activation the activation properties:Properties the properties of the original table. Used to help the store use optimal page size, etc. resultDescription:ResultDescription the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null

TemporaryRowHolderImpl

back to summary

public TemporaryRowHolderImpl(Activation activation, Properties properties, ResultDescription resultDescription)

Uses the default overflow to a conglomerate threshold (5).

Parameters

activation:Activation: the activation
properties:Properties: the properties of the original table. Used to help the store use optimal page size, etc.
resultDescription:ResultDescription: the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null

TemporaryRowHolderImpl	back to summary
public TemporaryRowHolderImpl(Activation activation, Properties properties, ResultDescription resultDescription, boolean isUniqueStream) Uses the default overflow to a conglomerate threshold (5). Parameters activation:Activation the activation properties:Properties the properties of the original table. Used to help the store use optimal page size, etc. resultDescription:ResultDescription the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null isUniqueStream:boolean - true , if it has to be temporary row holder unique stream

TemporaryRowHolderImpl

back to summary

public TemporaryRowHolderImpl(Activation activation, Properties properties, ResultDescription resultDescription, boolean isUniqueStream)

Uses the default overflow to a conglomerate threshold (5).

Parameters

activation:Activation: the activation
properties:Properties: the properties of the original table. Used to help the store use optimal page size, etc.
resultDescription:ResultDescription: the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null
isUniqueStream:boolean: - true , if it has to be temporary row holder unique stream

TemporaryRowHolderImpl	back to summary
public TemporaryRowHolderImpl(Activation activation, Properties properties, ResultDescription resultDescription, int overflowToConglomThreshold, boolean isUniqueStream, boolean isVirtualMemHeap) Create a temporary row holder with the defined overflow to conglom Parameters activation:Activation the activation properties:Properties the properties of the original table. Used to help the store use optimal page size, etc. resultDescription:ResultDescription the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null overflowToConglomThreshold:int on an attempt to insert this number of rows, the rows will be put into a temporary conglomerate.

TemporaryRowHolderImpl

back to summary

public TemporaryRowHolderImpl(Activation activation, Properties properties, ResultDescription resultDescription, int overflowToConglomThreshold, boolean isUniqueStream, boolean isVirtualMemHeap)

Create a temporary row holder with the defined overflow to conglom

Parameters

activation:Activation: the activation
properties:Properties: the properties of the original table. Used to help the store use optimal page size, etc.
resultDescription:ResultDescription: the result description. Relevant for the getResultDescription call on the result set returned by getResultSet. May be null
overflowToConglomThreshold:int: on an attempt to insert this number of rows, the rows will be put into a temporary conglomerate.

Method Detail

cloneRow	back to summary
private ExecRow cloneRow(ExecRow inputRow)

close	back to summary
public void close() throws StandardException Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.close. Clean up Exceptions StandardException: on error

back to summary

public void close() throws StandardException

Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.close.

Clean up

Exceptions

StandardException:: on error

getPositionIndexConglomId	back to summary
public long getPositionIndexConglomId() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getPositionIndexConglomId.

getResultSet	back to summary
public CursorResultSet getResultSet() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getResultSet. Get a result set for scanning what has been inserted so far. Returns:CursorResultSet a result set to use

getResultSet

back to summary

public CursorResultSet getResultSet()

Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getResultSet.

Get a result set for scanning what has been inserted so far.

Returns:CursorResultSet: a result set to use

getTemporaryConglomId	back to summary
public long getTemporaryConglomId() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getTemporaryConglomId. Accessor to get the id of the temporary conglomerate. Temporary conglomerates have negative ids. An id equal to zero means that no temporary conglomerate has been created. Returns:long Conglomerate ID of temporary conglomerate

getTemporaryConglomId

back to summary

public long getTemporaryConglomId()

Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.getTemporaryConglomId.

Accessor to get the id of the temporary conglomerate. Temporary conglomerates have negative ids. An id equal to zero means that no temporary conglomerate has been created.

Returns:long: Conglomerate ID of temporary conglomerate

insert	back to summary
public void insert(ExecRow inputRow) throws StandardException Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.insert. Insert a row Parameters inputRow:ExecRow the row to insert Exceptions StandardException: on error

insert

back to summary

public void insert(ExecRow inputRow) throws StandardException

Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.insert.

Insert a row

Parameters

inputRow:ExecRow: the row to insert

Exceptions

StandardException:: on error

insertToPositionIndex	back to summary
private void insertToPositionIndex(int position, RowLocation rl) throws StandardException Maintain an index that will allow us to read from the temporary heap in the order we inserted. Parameters position:int - the number of the row we are inserting into heap rl:RowLocation the row to Location in the temporary heap Exceptions StandardException: on error

insertToPositionIndex

back to summary

private void insertToPositionIndex(int position, RowLocation rl) throws StandardException

Maintain an index that will allow us to read from the temporary heap in the order we inserted.

Parameters

position:int: - the number of the row we are inserting into heap
rl:RowLocation: the row to Location in the temporary heap

Exceptions

StandardException:: on error

isRowAlreadyExist	back to summary
private boolean isRowAlreadyExist(ExecRow inputRow) throws StandardException Maintain an unique index based on the input row's row location in the base table, this index make sures that we don't insert duplicate rows into the temporary heap. Parameters inputRow:ExecRow the row we are inserting to temporary row holder Exceptions StandardException: on error

isRowAlreadyExist

back to summary

private boolean isRowAlreadyExist(ExecRow inputRow) throws StandardException

Maintain an unique index based on the input row's row location in the base table, this index make sures that we don't insert duplicate rows into the temporary heap.

Parameters

inputRow:ExecRow: the row we are inserting to temporary row holder

Exceptions

StandardException:: on error

makeIndexProperties	back to summary
private Properties makeIndexProperties(DataValueDescriptor[] indexRowArray, long conglomId) throws StandardException

makeTemplateRow	back to summary
private DataValueDescriptor[] makeTemplateRow(DataValueDescriptor[] originalRow) throws StandardException Make a template row for creating the spillover conglomerate. We only do this for MERGE statments. MERGE processing can temporarily stuff literal nulls into the DataValueDescriptor slot for an autoincrement column. The null DataValueDescriptor can not be used to create the layout of the spillover conglomerate. See DERBY-7144. Parameters originalRow:DataValueDescriptor[] The original row

makeTemplateRow

back to summary

private DataValueDescriptor[] makeTemplateRow(DataValueDescriptor[] originalRow) throws StandardException

Make a template row for creating the spillover conglomerate. We only do this for MERGE statments. MERGE processing can temporarily stuff literal nulls into the DataValueDescriptor slot for an autoincrement column. The null DataValueDescriptor can not be used to create the layout of the spillover conglomerate. See DERBY-7144.

Parameters

originalRow:DataValueDescriptor[]: The original row

setRowHolderTypeToUniqueStream	back to summary
public void setRowHolderTypeToUniqueStream() Implements org.apache.derby.iapi.sql.execute.TemporaryRowHolder.setRowHolderTypeToUniqueStream.

truncate	back to summary
public void truncate() throws StandardException Purge the row holder of all its rows. Resets the row holder so that it can accept new inserts. A cheap way to recycle a row holder. Exceptions StandardException: on error

truncate

back to summary

public void truncate() throws StandardException

Purge the row holder of all its rows. Resets the row holder so that it can accept new inserts. A cheap way to recycle a row holder.

Exceptions

StandardException:: on error

pack-priv Class TemporaryRowHolderImpl

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail