org.apache.ignite.internal.processors.query.h2.opt

Class GridH2Table

java.lang.Object

org.gridgain.internal.h2.engine.DbObjectBase

org.gridgain.internal.h2.schema.SchemaObjectBase

org.gridgain.internal.h2.table.Table

org.gridgain.internal.h2.table.TableBase

org.apache.ignite.internal.processors.query.h2.opt.GridH2Table

All Implemented Interfaces:

org.gridgain.internal.h2.engine.DbObject, org.gridgain.internal.h2.schema.SchemaObject

public class GridH2Table
extends org.gridgain.internal.h2.table.TableBase

H2 Table implementation.

Field Summary

Fields inherited from class org.gridgain.internal.h2.table.Table

columns, compareMode, isHidden, TYPE_CACHED, TYPE_MEMORY

Fields inherited from class org.gridgain.internal.h2.engine.DbObjectBase

comment, database, trace

Fields inherited from interface org.gridgain.internal.h2.engine.DbObject

AGGREGATE, COMMENT, CONSTANT, CONSTRAINT, DOMAIN, FUNCTION_ALIAS, INDEX, RIGHT, ROLE, SCHEMA, SEQUENCE, SETTING, SYNONYM, TABLE_OR_VIEW, TRIGGER, USER

Constructor Summary

Constructors

Constructor and Description
GridH2Table(org.gridgain.internal.h2.command.ddl.CreateTableData createTblData, GridH2RowDescriptor desc, H2TableDescriptor tblDesc, GridCacheContextInfo cacheInfo) Creates table.

Method Summary

Modifier and Type	Method and Description
void	addColumns(List<QueryField> cols, boolean ifNotExists) Add new columns to this table.
org.gridgain.internal.h2.index.Index	addIndex(org.gridgain.internal.h2.engine.Session ses, String idxName, int idxId, org.gridgain.internal.h2.table.IndexColumn[] cols, org.gridgain.internal.h2.index.IndexType idxType, boolean create, String idxComment)
void	addRow(org.gridgain.internal.h2.engine.Session ses, org.gridgain.internal.h2.result.Row row)
@Nullable GridCacheContext	cacheContext()
int	cacheId()
GridCacheContextInfo	cacheInfo()
String	cacheName()
boolean	canDrop()
boolean	canGetRowCount()
boolean	checkIfIndexesRebuildRequired()
void	checkRename()
void	checkSupportAlter()
static void	checkTablesVersions(org.gridgain.internal.h2.engine.Session s)
void	close(org.gridgain.internal.h2.engine.Session ses)
void	collectIndexesForPartialRebuild(IndexRebuildPartialClosure clo, boolean force) Collect indexes for rebuild.
void	destroy() Destroy the table.
void	dropColumns(List<String> cols, boolean ifExists) Drop columns.
@Nullable org.gridgain.internal.h2.table.IndexColumn	getAffinityKeyColumn()
org.gridgain.internal.h2.table.Column[]	getColumns()
long	getDiskSpaceUsed()
@Nullable org.gridgain.internal.h2.table.IndexColumn	getExplicitAffinityKeyColumn()
ArrayList<org.gridgain.internal.h2.index.Index>	getIndexes()
@Nullable org.gridgain.internal.h2.index.Index	getIndexSafe(String indexName) Get an index by name.
long	getMaxDataModificationId()
long	getRowCount(@Nullable org.gridgain.internal.h2.engine.Session ses)
long	getRowCountApproximation(org.gridgain.internal.h2.engine.Session ses)
org.gridgain.internal.h2.index.Index	getScanIndex(org.gridgain.internal.h2.engine.Session ses)
org.gridgain.internal.h2.table.TableType	getTableType()
org.gridgain.internal.h2.index.Index	getUniqueIndex()
QueryTable	identifier()
String	identifierString()
org.gridgain.internal.h2.table.IndexColumn	indexColumn(int col, int sorting) Creates index column for table.
List<IndexInformation>	indexesInformation()
boolean	isCacheLazy()
boolean	isColumnForPartitionPruning(org.gridgain.internal.h2.table.Column col) Check whether passed column can be used for partition pruning.
boolean	isColumnForPartitionPruningStrict(org.gridgain.internal.h2.table.Column col) Check whether passed column could be used for partition transfer during partition pruning on joined tables and for external affinity calculation (e.g. on thin clients).
boolean	isCustomAffinityMapper()
boolean	isDeterministic()
boolean	isLockedExclusively()
boolean	isLockedExclusivelyBy(org.gridgain.internal.h2.engine.Session ses)
boolean	isPartitioned()
boolean	lock(org.gridgain.internal.h2.engine.Session ses, boolean exclusive, boolean force)
void	markRebuildFromHashInProgress(boolean value) Mark or unmark index rebuild state.
void	prepareIndexesForRebuild(org.gridgain.internal.h2.engine.Session session) Destroys the old data and recreate the index.
void	proposeUserIndex(org.gridgain.internal.h2.index.Index idx) Add index that is in an intermediate state and is still being built, thus is not used in queries until it is promoted.
static void	readLockTables(org.gridgain.internal.h2.engine.Session s)
boolean	rebuildFromHashInProgress()
boolean	remove(CacheDataRow row) Remove row.
void	removeChildrenAndResources(org.gridgain.internal.h2.engine.Session ses)
void	removeIndex(org.gridgain.internal.h2.index.Index h2Idx)
void	removeIndex(org.gridgain.internal.h2.engine.Session session, org.gridgain.internal.h2.index.Index h2Idx) Remove the given index from the list.
void	removeRow(org.gridgain.internal.h2.engine.Session ses, org.gridgain.internal.h2.result.Row row)
void	rollbackUserIndex(String idxName) Remove user index without promoting it.
GridH2RowDescriptor	rowDescriptor()
byte[]	rowKeyBytes(Object row)
byte[]	rowValueBytes(Object row)
protected void	setColumns(org.gridgain.internal.h2.table.Column[] columns)
void	setRemoveIndexOnDestroy(boolean rmIndex) If flag True, index will be destroyed when table destroy().
ObjectStatistics	tableStatistics() Get actual table statistics if exists.
void	truncate(org.gridgain.internal.h2.engine.Session ses)
void	unlock(org.gridgain.internal.h2.engine.Session ses)
static void	unlockTables(org.gridgain.internal.h2.engine.Session s)
void	update(CacheDataRow row, @Nullable CacheDataRow prevRow, boolean prevRowAvailable) Updates table for given key.
@Nullable org.gridgain.internal.h2.index.Index	userIndex(String idxName) Get user index with provided name.

Methods inherited from class org.gridgain.internal.h2.table.TableBase

getCreateSQL, getDropSQL, getMainIndexColumn, isGlobalTemporary

Methods inherited from class org.gridgain.internal.h2.table.Table

addConstraint, addDependencies, addDependentView, addSequence, addSynonym, addTrigger, canReference, canTruncate, checkDeadlock, checkWritingAllowed, compareValues, createRow, doesColumnExist, dropMultipleColumnsConstraintsAndIndexes, findPrimaryKey, fire, fireAfterRow, fireBeforeRow, fireRow, getBestPlanItem, getCheckForeignKeyConstraints, getChildren, getColumn, getColumn, getCompareMode, getConstraints, getCreateSQLForCopy, getDefaultValue, getDependentViews, getIndex, getIndexForColumn, getOnCommitDrop, getOnCommitTruncate, getOnUpdateValue, getPrimaryKey, getRow, getRowIdColumn, getScanIndex, getSearchRow, getTemplateRow, getTemplateSimpleRow, getType, getVisibleColums, hasSelectTrigger, isHidden, isMVStore, isPersistData, isPersistIndexes, isQueryComparable, isTableExpression, isView, lockRow, removeConstraint, removeDependentView, removeIndexOrTransferOwnership, removeSequence, removeSynonym, removeTrigger, rename, renameColumn, setCheckForeignKeyConstraints, setHidden, setOnCommitDrop, setOnCommitTruncate, setTableExpression, updateRow, updateRows, validateConvertUpdateSequence

Methods inherited from class org.gridgain.internal.h2.schema.SchemaObjectBase

getSchema, getSQL, getSQL

Methods inherited from class org.gridgain.internal.h2.engine.DbObjectBase

getComment, getDatabase, getId, getModificationId, getName, invalidate, isTemporary, isValid, setComment, setModified, setObjectName, setTemporary, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.gridgain.internal.h2.engine.DbObject

getComment, getDatabase, getId, getName, isTemporary, setComment, setTemporary

Constructor Detail

GridH2Table

public GridH2Table(org.gridgain.internal.h2.command.ddl.CreateTableData createTblData,
                   GridH2RowDescriptor desc,
                   H2TableDescriptor tblDesc,
                   GridCacheContextInfo cacheInfo)

Creates table.

Parameters:

createTblData - Table description.

desc - Row descriptor.

tblDesc - Indexes factory.

cacheInfo - Cache context info.

Method Detail

indexesInformation

public List<IndexInformation> indexesInformation()

Returns:

Information about all indexes related to the table.

isPartitioned

public boolean isPartitioned()

Returns:

true If this is a partitioned table.

getAffinityKeyColumn

@Nullable
public @Nullable org.gridgain.internal.h2.table.IndexColumn getAffinityKeyColumn()

Returns:

Affinity key column or null if not available.

getExplicitAffinityKeyColumn

@Nullable
public @Nullable org.gridgain.internal.h2.table.IndexColumn getExplicitAffinityKeyColumn()

Returns:

Explicit affinity key column or null if not available (skip _KEY column or it's alias).

isColumnForPartitionPruning

public boolean isColumnForPartitionPruning(org.gridgain.internal.h2.table.Column col)

Check whether passed column can be used for partition pruning.

Parameters:

col - Column.

Returns:

True if affinity key column.

isColumnForPartitionPruningStrict

public boolean isColumnForPartitionPruningStrict(org.gridgain.internal.h2.table.Column col)

Check whether passed column could be used for partition transfer during partition pruning on joined tables and for external affinity calculation (e.g. on thin clients).

Note that it is different from isColumnForPartitionPruning(Column) method in that not every column which qualifies for partition pruning can be used by thin clients or join partition pruning logic.

Consider the following schema:

 CREATE TABLE dept (id PRIMARY KEY);
 CREATE TABLE emp (id, dept_id AFFINITY KEY, PRIMARY KEY(id, dept_id));
 

For expression-based partition pruning on "emp" table on the server side we may use both "_KEY" and "dept_id" columns, as passing them through standard affinity workflow will yield the same result: dept_id -> part _KEY -> dept_id -> part

But we cannot use "_KEY" on thin client side, as it doesn't know how to extract affinity key field properly. Neither we can perform partition transfer in JOINs when "_KEY" is used.

This is OK as data is collocated, so we can merge partitions extracted from both tables:

 SELECT * FROM dept d INNER JOIN emp e ON d.id = e.dept_id WHERE e.dept_id=? AND d.id=?
 

But this is not OK as joined data is not collocated, and tables form distinct collocation groups:

 SELECT * FROM dept d INNER JOIN emp e ON d.id = e._KEY WHERE e.dept_id=? AND d.id=?
 

NB: The last query is not logically correct and will produce empty result. However, it is correct from SQL perspective, so we should make incorrect assumptions about partitions as it may make situation even worse.

Parameters:

col - Column.

Returns:

True if column could be used for partition extraction on both server and client sides and for partition transfer in joins.

isCustomAffinityMapper

public boolean isCustomAffinityMapper()

Returns:

Whether custom affintiy mapper is used.

getDiskSpaceUsed

public long getDiskSpaceUsed()

Specified by:

getDiskSpaceUsed in class org.gridgain.internal.h2.table.Table

rowDescriptor

public GridH2RowDescriptor rowDescriptor()

Returns:

Row descriptor.

cacheName

public String cacheName()

Returns:

Cache name.

cacheId

public int cacheId()

Returns:

Cache ID.

cacheInfo

public GridCacheContextInfo cacheInfo()

Returns:

Cache context info.

isCacheLazy

public boolean isCacheLazy()

Returns:

true If Cache is lazy (not full inited).

tableStatistics

public ObjectStatistics tableStatistics()

Get actual table statistics if exists.

Returns:

Table statistics or null if there is no statistics available.

cacheContext

@Nullable
public @Nullable GridCacheContext cacheContext()

Returns:

Cache context.

lock

public boolean lock(org.gridgain.internal.h2.engine.Session ses,
                    boolean exclusive,
                    boolean force)

Specified by:

lock in class org.gridgain.internal.h2.table.Table

unlock

public void unlock(org.gridgain.internal.h2.engine.Session ses)

Specified by:

unlock in class org.gridgain.internal.h2.table.Table

identifier

public QueryTable identifier()

Returns:

Table identifier.

identifierString

public String identifierString()

Returns:

Table identifier as string.

close

public void close(org.gridgain.internal.h2.engine.Session ses)

Specified by:

close in class org.gridgain.internal.h2.table.Table

removeChildrenAndResources

public void removeChildrenAndResources(org.gridgain.internal.h2.engine.Session ses)

Specified by:

removeChildrenAndResources in interface org.gridgain.internal.h2.engine.DbObject

Overrides:

removeChildrenAndResources in class org.gridgain.internal.h2.table.Table

destroy

public void destroy()

Destroy the table.

setRemoveIndexOnDestroy

public void setRemoveIndexOnDestroy(boolean rmIndex)

If flag True, index will be destroyed when table destroy().

Parameters:

rmIndex - Flag indicate remove index on destroy or not.

update

public void update(CacheDataRow row,
                   @Nullable
                   @Nullable CacheDataRow prevRow,
                   boolean prevRowAvailable)
            throws IgniteCheckedException

Updates table for given key. If value is null then row with given key will be removed from table, otherwise value and expiration time will be updated or new row will be added.

Parameters:

row - Row to be updated.

prevRow - Previous row.

prevRowAvailable - Whether previous row is available.

Throws:

IgniteCheckedException - If failed.

remove

public boolean remove(CacheDataRow row)
               throws IgniteCheckedException

Remove row.

Parameters:

row - Row.

Returns:

True if was removed.

Throws:

IgniteCheckedException - If failed.

collectIndexesForPartialRebuild

public void collectIndexesForPartialRebuild(IndexRebuildPartialClosure clo,
                                            boolean force)

Collect indexes for rebuild.

Parameters:

clo - Closure.

force - Force rebuild indexes.

checkIfIndexesRebuildRequired

public boolean checkIfIndexesRebuildRequired()

markRebuildFromHashInProgress

public void markRebuildFromHashInProgress(boolean value)

Mark or unmark index rebuild state.

rebuildFromHashInProgress

public boolean rebuildFromHashInProgress()

addIndex

public org.gridgain.internal.h2.index.Index addIndex(org.gridgain.internal.h2.engine.Session ses,
                                                     String idxName,
                                                     int idxId,
                                                     org.gridgain.internal.h2.table.IndexColumn[] cols,
                                                     org.gridgain.internal.h2.index.IndexType idxType,
                                                     boolean create,
                                                     String idxComment)

Specified by:

addIndex in class org.gridgain.internal.h2.table.Table

proposeUserIndex

public void proposeUserIndex(org.gridgain.internal.h2.index.Index idx)
                      throws IgniteCheckedException

Add index that is in an intermediate state and is still being built, thus is not used in queries until it is promoted.

Parameters:

idx - Index to add.

Throws:

IgniteCheckedException - If failed.

rollbackUserIndex

public void rollbackUserIndex(String idxName)

Remove user index without promoting it.

Parameters:

idxName - Index name.

userIndex

@Nullable
public @Nullable org.gridgain.internal.h2.index.Index userIndex(String idxName)

Get user index with provided name.

Parameters:

idxName - Index name.

Returns:

User index if exists and null othwerwise.

removeIndex

public void removeIndex(org.gridgain.internal.h2.index.Index h2Idx)

Overrides:

removeIndex in class org.gridgain.internal.h2.table.Table

removeIndex

public void removeIndex(org.gridgain.internal.h2.engine.Session session,
                        org.gridgain.internal.h2.index.Index h2Idx)

Remove the given index from the list.

Parameters:

h2Idx - the index to remove

removeRow

public void removeRow(org.gridgain.internal.h2.engine.Session ses,
                      org.gridgain.internal.h2.result.Row row)

Specified by:

removeRow in class org.gridgain.internal.h2.table.Table

truncate

public void truncate(org.gridgain.internal.h2.engine.Session ses)

Specified by:

truncate in class org.gridgain.internal.h2.table.Table

addRow

public void addRow(org.gridgain.internal.h2.engine.Session ses,
                   org.gridgain.internal.h2.result.Row row)

Specified by:

addRow in class org.gridgain.internal.h2.table.Table

checkSupportAlter

public void checkSupportAlter()

Specified by:

checkSupportAlter in class org.gridgain.internal.h2.table.Table

getTableType

public org.gridgain.internal.h2.table.TableType getTableType()

Specified by:

getTableType in class org.gridgain.internal.h2.table.Table

getScanIndex

public org.gridgain.internal.h2.index.Index getScanIndex(org.gridgain.internal.h2.engine.Session ses)

Specified by:

getScanIndex in class org.gridgain.internal.h2.table.Table

getUniqueIndex

public org.gridgain.internal.h2.index.Index getUniqueIndex()

Specified by:

getUniqueIndex in class org.gridgain.internal.h2.table.Table

getIndexes

public ArrayList<org.gridgain.internal.h2.index.Index> getIndexes()

Specified by:

getIndexes in class org.gridgain.internal.h2.table.Table

isLockedExclusively

public boolean isLockedExclusively()

Specified by:

isLockedExclusively in class org.gridgain.internal.h2.table.Table

isLockedExclusivelyBy

public boolean isLockedExclusivelyBy(org.gridgain.internal.h2.engine.Session ses)

Overrides:

isLockedExclusivelyBy in class org.gridgain.internal.h2.table.Table

getMaxDataModificationId

public long getMaxDataModificationId()

Specified by:

getMaxDataModificationId in class org.gridgain.internal.h2.table.Table

isDeterministic

public boolean isDeterministic()

Specified by:

isDeterministic in class org.gridgain.internal.h2.table.Table

canGetRowCount

public boolean canGetRowCount()

Specified by:

canGetRowCount in class org.gridgain.internal.h2.table.Table

canDrop

public boolean canDrop()

Specified by:

canDrop in class org.gridgain.internal.h2.table.Table

getRowCount

public long getRowCount(@Nullable
                        @Nullable org.gridgain.internal.h2.engine.Session ses)

Specified by:

getRowCount in class org.gridgain.internal.h2.table.Table

getRowCountApproximation

public long getRowCountApproximation(org.gridgain.internal.h2.engine.Session ses)

Specified by:

getRowCountApproximation in class org.gridgain.internal.h2.table.Table

prepareIndexesForRebuild

public void prepareIndexesForRebuild(org.gridgain.internal.h2.engine.Session session)
                              throws IgniteCheckedException

Destroys the old data and recreate the index.

Parameters:

session - Session.

Throws:

IgniteCheckedException - In case we were unable to destroy the data.

checkRename

public void checkRename()

Specified by:

checkRename in interface org.gridgain.internal.h2.engine.DbObject

Specified by:

checkRename in class org.gridgain.internal.h2.engine.DbObjectBase

indexColumn

public org.gridgain.internal.h2.table.IndexColumn indexColumn(int col,
                                                              int sorting)

Creates index column for table.

Parameters:

col - Column index.

sorting - Sorting order SortOrder

Returns:

Created index column.

addColumns

public void addColumns(List<QueryField> cols,
                       boolean ifNotExists)

Add new columns to this table.

Parameters:

cols - Columns to add.

ifNotExists - Ignore this command if cols has size of 1 and column with given name already exists.

dropColumns

public void dropColumns(List<String> cols,
                        boolean ifExists)

Drop columns.

Parameters:

cols - Columns.

ifExists - If EXISTS flag.

setColumns

protected void setColumns(org.gridgain.internal.h2.table.Column[] columns)

Overrides:

setColumns in class org.gridgain.internal.h2.table.Table

getColumns

public org.gridgain.internal.h2.table.Column[] getColumns()

Overrides:

getColumns in class org.gridgain.internal.h2.table.Table

unlockTables

public static void unlockTables(org.gridgain.internal.h2.engine.Session s)

Parameters:

s - H2 session.

readLockTables

public static void readLockTables(org.gridgain.internal.h2.engine.Session s)

Parameters:

s - H2 session.

checkTablesVersions

public static void checkTablesVersions(org.gridgain.internal.h2.engine.Session s)

Parameters:

s - H2 session.

rowValueBytes

public byte[] rowValueBytes(Object row)

rowKeyBytes

public byte[] rowKeyBytes(Object row)

getIndexSafe

@Nullable
public @Nullable org.gridgain.internal.h2.index.Index getIndexSafe(String indexName)

Get an index by name.

Parameters:

indexName - Index name to search for.

Returns:

Found index, null if not found.