Package org.h2.mvstore.db

Class MVPrimaryIndex

java.lang.Object

org.h2.engine.DbObject

org.h2.schema.SchemaObject

org.h2.index.Index

org.h2.mvstore.db.MVIndex<java.lang.Long,SearchRow>

org.h2.mvstore.db.MVPrimaryIndex

All Implemented Interfaces:

HasSQL

public class MVPrimaryIndex
extends MVIndex<java.lang.Long,SearchRow>

A table stored in a MVStore.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	MVPrimaryIndex.MVStoreCursor	A cursor.

Field Summary

Fields

Modifier and Type	Field	Description
private TransactionMap<java.lang.Long,SearchRow>	dataMap
private java.util.concurrent.atomic.AtomicLong	lastKey
private int	mainIndexColumn
private java.lang.String	mapName
private MVTable	mvTable

Fields inherited from class org.h2.index.Index

columnIds, columns, indexColumns, indexType, table, uniqueColumnColumn

Fields inherited from class org.h2.engine.DbObject

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

Fields inherited from interface org.h2.util.HasSQL

ADD_PLAN_INFORMATION, DEFAULT_SQL_FLAGS, NO_CASTS, QUOTE_ONLY_WHEN_REQUIRED, REPLACE_LOBS_FOR_TRACE, TRACE_SQL_FLAGS

Constructor Summary

Constructors

Constructor	Description
MVPrimaryIndex(Database db, MVTable table, int id, IndexColumn[] columns, IndexType indexType)

Method Summary

Modifier and Type	Method	Description
void	add(SessionLocal session, Row row)	Add a row to the index.
void	addBufferedRows(java.util.List<java.lang.String> bufferNames)	Add all the index data from the buffers to the index.
void	addRowsToBuffer(java.util.List<Row> rows, java.lang.String bufferName)	Add the rows to a temporary storage (not to the index yet).
boolean	canGetFirstOrLast()	Check if the index can directly look up the lowest or highest value of a column.
void	close(SessionLocal session)	Close this index.
private long	extractPKFromRow(SearchRow row, long defaultValue)
private Cursor	find(SessionLocal session, java.lang.Long first, java.lang.Long last)
Cursor	find(SessionLocal session, SearchRow first, SearchRow last)	Find a row or a list of rows and create a cursor to iterate over the result.
Cursor	findFirstOrLast(SessionLocal session, boolean first)	Find the first (or last) value of this index.
int	getColumnIndex(Column col)	Get the index of a column in the list of index columns
double	getCost(SessionLocal session, int[] masks, TableFilter[] filters, int filter, SortOrder sortOrder, AllColumnsForPlan allColumnsSet)	Estimate the cost to search for rows given the search mask.
java.lang.String	getCreateSQL()	Construct the CREATE ...
long	getDiskSpaceUsed()	Get the used disk space for this index.
int	getMainIndexColumn()
(package private) TransactionMap<java.lang.Long,SearchRow>	getMap(SessionLocal session)	Get the map to store the data.
java.lang.String	getMapName()
MVMap<java.lang.Long,VersionedValue<SearchRow>>	getMVMap()
java.lang.String	getPlanSQL()	Get the message to show in a EXPLAIN statement.
Row	getRow(SessionLocal session, long key)	Get the row with the given key.
long	getRowCount(SessionLocal session)	Get the row count of this table, for the given session.
long	getRowCountApproximation(SessionLocal session)	Get the approximated row count for this table.
long	getRowCountMax()	The maximum number of rows, including uncommitted rows of any session.
MVTable	getTable()	Get the table on which this index is based.
boolean	isFirstColumn(Column column)	Check if the given column is the first for this index
boolean	isRowIdIndex()	Does this index support lookup by row id?
(package private) Row	lockRow(SessionLocal session, Row row)	Lock a single row.
private Row	lockRow(TransactionMap<java.lang.Long,SearchRow> map, long key)
boolean	needRebuild()	Check if the index needs to be rebuilt.
void	remove(SessionLocal session)	Remove the index.
void	remove(SessionLocal session, Row row)	Remove a row from the index.
void	setMainIndexColumn(int mainIndexColumn)
private static Row	setRowKey(Row row, long key)
void	truncate(SessionLocal session)	Remove all rows from the index.
void	update(SessionLocal session, Row oldRow, Row newRow)	Update index after row change.

Methods inherited from class org.h2.index.Index

canFindNext, canScan, checkIndexColumnTypes, compareRows, findNext, getColumns, getCostRangeIndex, getCreateSQLForCopy, getDuplicateKeyException, getDuplicatePrimaryKeyMessage, getIndexColumns, getIndexType, getRowFactory, getType, getUniqueColumnCount, getUniqueRowFactory, isFindUsingFullTableScan, isHidden, mayHaveNullDuplicates, removeChildrenAndResources

Methods inherited from class org.h2.schema.SchemaObject

getSchema, getSQL, getSQL

Methods inherited from class org.h2.engine.DbObject

checkRename, getChildren, getComment, getCreateSQLForMeta, getDatabase, getDropSQL, getId, getModificationId, getName, invalidate, isTemporary, isValid, rename, 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.h2.util.HasSQL

getTraceSQL

Field Detail

mvTable

private final MVTable mvTable

mapName

private final java.lang.String mapName

dataMap

private final TransactionMap<java.lang.Long,SearchRow> dataMap

lastKey

private final java.util.concurrent.atomic.AtomicLong lastKey

mainIndexColumn

private int mainIndexColumn

Constructor Detail

MVPrimaryIndex

public MVPrimaryIndex(Database db,
                      MVTable table,
                      int id,
                      IndexColumn[] columns,
                      IndexType indexType)

Method Detail

getCreateSQL

public java.lang.String getCreateSQL()

Description copied from class: DbObject

Construct the CREATE ... SQL statement for this object.

Overrides:

getCreateSQL in class Index

Returns:

the SQL statement

getPlanSQL

public java.lang.String getPlanSQL()

Description copied from class: Index

Get the message to show in a EXPLAIN statement.

Overrides:

getPlanSQL in class Index

Returns:

the plan

setMainIndexColumn

public void setMainIndexColumn(int mainIndexColumn)

getMainIndexColumn

public int getMainIndexColumn()

close

public void close(SessionLocal session)

Description copied from class: Index

Close this index.

Specified by:

close in class Index

Parameters:

session - the session used to write data

add

public void add(SessionLocal session,
                Row row)

Description copied from class: Index

Add a row to the index.

Specified by:

add in class Index

Parameters:

session - the session to use

row - the row to add

remove

public void remove(SessionLocal session,
                   Row row)

Description copied from class: Index

Remove a row from the index.

Specified by:

remove in class Index

Parameters:

session - the session

row - the row

update

public void update(SessionLocal session,
                   Row oldRow,
                   Row newRow)

Description copied from class: Index

Update index after row change.

Overrides:

update in class Index

Parameters:

session - the session

oldRow - row before the update

newRow - row after the update

lockRow

Row lockRow(SessionLocal session,
            Row row)

Lock a single row.

Parameters:

session - database session

row - to lock

Returns:

row object if it exists

lockRow

private Row lockRow(TransactionMap<java.lang.Long,SearchRow> map,
                    long key)

find

public Cursor find(SessionLocal session,
                   SearchRow first,
                   SearchRow last)

Description copied from class: Index

Find a row or a list of rows and create a cursor to iterate over the result.

Specified by:

find in class Index

Parameters:

session - the session

first - the first row, or null for no limit

last - the last row, or null for no limit

Returns:

the cursor to iterate over the results

extractPKFromRow

private long extractPKFromRow(SearchRow row,
                              long defaultValue)

getTable

public MVTable getTable()

Description copied from class: Index

Get the table on which this index is based.

Overrides:

getTable in class Index

Returns:

the table

getRow

public Row getRow(SessionLocal session,
                  long key)

Description copied from class: Index

Get the row with the given key.

Overrides:

getRow in class Index

Parameters:

session - the session

key - the unique key

Returns:

the row

getCost

public double getCost(SessionLocal session,
                      int[] masks,
                      TableFilter[] filters,
                      int filter,
                      SortOrder sortOrder,
                      AllColumnsForPlan allColumnsSet)

Description copied from class: Index

Estimate the cost to search for rows given the search mask. There is one element per column in the search mask. For possible search masks, see IndexCondition.

Specified by:

getCost in class Index

Parameters:

session - the session

masks - per-column comparison bit masks, null means 'always false', see constants in IndexCondition

filters - all joined table filters

filter - the current table filter index

sortOrder - the sort order

allColumnsSet - the set of all columns

Returns:

the estimated cost

getColumnIndex

public int getColumnIndex(Column col)

Description copied from class: Index

Get the index of a column in the list of index columns

Overrides:

getColumnIndex in class Index

Parameters:

col - the column

Returns:

the index (0 meaning first column)

isFirstColumn

public boolean isFirstColumn(Column column)

Description copied from class: Index

Check if the given column is the first for this index

Overrides:

isFirstColumn in class Index

Parameters:

column - the column

Returns:

true if the given columns is the first

remove

public void remove(SessionLocal session)

Description copied from class: Index

Remove the index.

Specified by:

remove in class Index

Parameters:

session - the session

truncate

public void truncate(SessionLocal session)

Description copied from class: Index

Remove all rows from the index.

Specified by:

truncate in class Index

Parameters:

session - the session

canGetFirstOrLast

public boolean canGetFirstOrLast()

Description copied from class: Index

Check if the index can directly look up the lowest or highest value of a column.

Overrides:

canGetFirstOrLast in class Index

Returns:

true if it can

findFirstOrLast

public Cursor findFirstOrLast(SessionLocal session,
                              boolean first)

Description copied from class: Index

Find the first (or last) value of this index. The cursor returned is positioned on the correct row, or on null if no row has been found.

Overrides:

findFirstOrLast in class Index

Parameters:

session - the session

first - true if the first (lowest for ascending indexes) or last value should be returned

Returns:

a cursor (never null)

needRebuild

public boolean needRebuild()

Description copied from class: Index

Check if the index needs to be rebuilt. This method is called after opening an index.

Specified by:

needRebuild in class Index

Returns:

true if a rebuild is required.

getRowCount

public long getRowCount(SessionLocal session)

Description copied from class: Index

Get the row count of this table, for the given session.

Specified by:

getRowCount in class Index

Parameters:

session - the session

Returns:

the row count

getRowCountMax

public long getRowCountMax()

The maximum number of rows, including uncommitted rows of any session.

Returns:

the maximum number of rows

getRowCountApproximation

public long getRowCountApproximation(SessionLocal session)

Description copied from class: Index

Get the approximated row count for this table.

Specified by:

getRowCountApproximation in class Index

Parameters:

session - the session

Returns:

the approximated row count

getDiskSpaceUsed

public long getDiskSpaceUsed()

Description copied from class: Index

Get the used disk space for this index.

Overrides:

getDiskSpaceUsed in class Index

Returns:

the estimated number of bytes

getMapName

public java.lang.String getMapName()

addRowsToBuffer

public void addRowsToBuffer(java.util.List<Row> rows,
                            java.lang.String bufferName)

Description copied from class: MVIndex

Add the rows to a temporary storage (not to the index yet). The rows are sorted by the index columns. This is to more quickly build the index.

Specified by:

addRowsToBuffer in class MVIndex<java.lang.Long,SearchRow>

Parameters:

rows - the rows

bufferName - the name of the temporary storage

addBufferedRows

public void addBufferedRows(java.util.List<java.lang.String> bufferNames)

Description copied from class: MVIndex

Add all the index data from the buffers to the index. The index will typically use merge sort to add the data more quickly in sorted order.

Specified by:

addBufferedRows in class MVIndex<java.lang.Long,SearchRow>

Parameters:

bufferNames - the names of the temporary storage

find

private Cursor find(SessionLocal session,
                    java.lang.Long first,
                    java.lang.Long last)

isRowIdIndex

public boolean isRowIdIndex()

Description copied from class: Index

Does this index support lookup by row id?

Overrides:

isRowIdIndex in class Index

Returns:

true if it does

getMap

TransactionMap<java.lang.Long,SearchRow> getMap(SessionLocal session)

Get the map to store the data.

Parameters:

session - the session

Returns:

the map

getMVMap

public MVMap<java.lang.Long,VersionedValue<SearchRow>> getMVMap()

Specified by:

getMVMap in class MVIndex<java.lang.Long,SearchRow>

setRowKey

private static Row setRowKey(Row row,
                             long key)