org.apache.omid.transaction

Class SnapshotFilterImpl

java.lang.Object

org.apache.omid.transaction.SnapshotFilterImpl

All Implemented Interfaces:

AutoCloseable, SnapshotFilter

public class SnapshotFilterImpl
extends Object
implements SnapshotFilter

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SnapshotFilterImpl.TransactionalClientScanner

Constructor Summary

Constructors

Constructor and Description
SnapshotFilterImpl(org.apache.omid.committable.CommitTable.Client commitTableClient)
SnapshotFilterImpl(TableAccessWrapper tableAccessWrapper)
SnapshotFilterImpl(TableAccessWrapper tableAccessWrapper, org.apache.omid.committable.CommitTable.Client commitTableClient)

Method Summary

Modifier and Type	Method and Description
void	close()
List<org.apache.hadoop.hbase.Cell>	filterCellsForSnapshot(List<org.apache.hadoop.hbase.Cell> rawCells, HBaseTransaction transaction, int versionsToRequest, Map<String,Long> familyDeletionCache, Map<String,byte[]> attributeMap) Filters the raw results returned from HBase and returns only those belonging to the current snapshot, as defined by the transaction object.
org.apache.hadoop.hbase.client.Result	get(org.apache.hadoop.hbase.client.Get get, HBaseTransaction transaction)
org.apache.hadoop.hbase.client.ResultScanner	getScanner(org.apache.hadoop.hbase.client.Scan scan, HBaseTransaction transaction)
TableAccessWrapper	getTableAccessWrapper()
org.apache.phoenix.thirdparty.com.google.common.base.Optional<Long>	getTSIfInSnapshot(org.apache.hadoop.hbase.Cell kv, HBaseTransaction transaction, Map<Long,Long> commitCache)
org.apache.phoenix.thirdparty.com.google.common.base.Optional<Long>	getTSIfInTransaction(org.apache.hadoop.hbase.Cell kv, HBaseTransaction transaction)
boolean	isCommitted(HBaseCellId hBaseCellId, long epoch, boolean isLowLatency)
org.apache.omid.committable.CommitTable.CommitTimestamp	locateCellCommitTimestamp(long cellStartTimestamp, long epoch, CommitTimestampLocator locator, boolean isLowLatency) This function returns the commit timestamp for a particular cell if the transaction was already committed in the system.
org.apache.phoenix.thirdparty.com.google.common.base.Optional<org.apache.omid.committable.CommitTable.CommitTimestamp>	readCommitTimestampFromShadowCell(long cellStartTimestamp, CommitTimestampLocator locator) Check if the transaction commit data is in the shadow cell
org.apache.phoenix.thirdparty.com.google.common.base.Optional<Long>	tryToLocateCellCommitTimestamp(long epoch, org.apache.hadoop.hbase.Cell cell, Map<Long,Long> commitCache, boolean isLowLatency)

Methods inherited from class java.lang.Object

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

Constructor Detail

SnapshotFilterImpl

public SnapshotFilterImpl(TableAccessWrapper tableAccessWrapper,
                          org.apache.omid.committable.CommitTable.Client commitTableClient)
                   throws IOException

Throws:

IOException

SnapshotFilterImpl

public SnapshotFilterImpl(TableAccessWrapper tableAccessWrapper)
                   throws IOException

Throws:

IOException

SnapshotFilterImpl

public SnapshotFilterImpl(org.apache.omid.committable.CommitTable.Client commitTableClient)
                   throws IOException

Throws:

IOException

Method Detail

getTableAccessWrapper

public TableAccessWrapper getTableAccessWrapper()

readCommitTimestampFromShadowCell

public org.apache.phoenix.thirdparty.com.google.common.base.Optional<org.apache.omid.committable.CommitTable.CommitTimestamp> readCommitTimestampFromShadowCell(long cellStartTimestamp,
                                                                                                                                                                CommitTimestampLocator locator)
                                                                                                                                                         throws IOException

Check if the transaction commit data is in the shadow cell

Parameters:

cellStartTimestamp - the transaction start timestamp locator the timestamp locator

Throws:

IOException

locateCellCommitTimestamp

public org.apache.omid.committable.CommitTable.CommitTimestamp locateCellCommitTimestamp(long cellStartTimestamp,
                                                                                         long epoch,
                                                                                         CommitTimestampLocator locator,
                                                                                         boolean isLowLatency)
                                                                                  throws IOException

This function returns the commit timestamp for a particular cell if the transaction was already committed in the system. In case the transaction was not committed and the cell was written by transaction initialized by a previous TSO server, an invalidation try occurs. Otherwise the function returns a value that indicates that the commit timestamp was not found.

Parameters:

cellStartTimestamp - start timestamp of the cell to locate the commit timestamp for.

epoch - the epoch of the TSO server the current tso client is working with.

locator - a locator to find the commit timestamp in the system.

Returns:

the commit timestamp joint with the location where it was found or an object indicating that it was not found in the system

Throws:

IOException - in case of any I/O issues

tryToLocateCellCommitTimestamp

public org.apache.phoenix.thirdparty.com.google.common.base.Optional<Long> tryToLocateCellCommitTimestamp(long epoch,
                                                                                                          org.apache.hadoop.hbase.Cell cell,
                                                                                                          Map<Long,Long> commitCache,
                                                                                                          boolean isLowLatency)
                                                                                                   throws IOException

Throws:

IOException

getTSIfInTransaction

public org.apache.phoenix.thirdparty.com.google.common.base.Optional<Long> getTSIfInTransaction(org.apache.hadoop.hbase.Cell kv,
                                                                                                HBaseTransaction transaction)

getTSIfInSnapshot

public org.apache.phoenix.thirdparty.com.google.common.base.Optional<Long> getTSIfInSnapshot(org.apache.hadoop.hbase.Cell kv,
                                                                                             HBaseTransaction transaction,
                                                                                             Map<Long,Long> commitCache)
                                                                                      throws IOException

Throws:

IOException

filterCellsForSnapshot

public List<org.apache.hadoop.hbase.Cell> filterCellsForSnapshot(List<org.apache.hadoop.hbase.Cell> rawCells,
                                                                 HBaseTransaction transaction,
                                                                 int versionsToRequest,
                                                                 Map<String,Long> familyDeletionCache,
                                                                 Map<String,byte[]> attributeMap)
                                                          throws IOException

Filters the raw results returned from HBase and returns only those belonging to the current snapshot, as defined by the transaction object. If the raw results don't contain enough information for a particular qualifier, it will request more versions from HBase.

Parameters:

rawCells - Raw cells that we are going to filter

transaction - Defines the current snapshot

versionsToRequest - Number of versions requested from hbase

familyDeletionCache - Accumulates the family deletion markers to identify cells that deleted with a higher version

Returns:

Filtered KVs belonging to the transaction snapshot

Throws:

IOException

get

public org.apache.hadoop.hbase.client.Result get(org.apache.hadoop.hbase.client.Get get,
                                                 HBaseTransaction transaction)
                                          throws IOException

Specified by:

get in interface SnapshotFilter

Throws:

IOException

getScanner

public org.apache.hadoop.hbase.client.ResultScanner getScanner(org.apache.hadoop.hbase.client.Scan scan,
                                                               HBaseTransaction transaction)
                                                        throws IOException

Specified by:

getScanner in interface SnapshotFilter

Throws:

IOException

isCommitted

public boolean isCommitted(HBaseCellId hBaseCellId,
                           long epoch,
                           boolean isLowLatency)
                    throws TransactionException

Throws:

TransactionException

close

public void close()
           throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception