Package org.apache.cassandra.db.memtable
Class ShardedSkipListMemtable
java.lang.Object
org.apache.cassandra.db.memtable.AbstractMemtable
org.apache.cassandra.db.memtable.AbstractMemtableWithCommitlog
org.apache.cassandra.db.memtable.AbstractAllocatorMemtable
org.apache.cassandra.db.memtable.AbstractShardedMemtable
org.apache.cassandra.db.memtable.ShardedSkipListMemtable
- All Implemented Interfaces:
Comparable<Memtable>,CellSourceIdentifier,Memtable,UnfilteredSource
A proof-of-concept sharded memtable implementation. This implementation splits the partition skip-list into several
independent skip-lists each covering a roughly equal part of the token space served by this node. This reduces
congestion of the skip-list from concurrent writes and can lead to improved write throughput.
The implementation takes two parameters:
- shards: the number of shards to split into.
- serialize_writes: if false, each shard may serve multiple writes in parallel; if true, writes to each shard are
synchronized.
Also see Memtable_API.md.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classNested classes/interfaces inherited from class org.apache.cassandra.db.memtable.AbstractMemtable
AbstractMemtable.AbstractFlushablePartitionSet<P extends Partition>, AbstractMemtable.ColumnsCollector, AbstractMemtable.StatsCollectorNested classes/interfaces inherited from interface org.apache.cassandra.db.memtable.Memtable
Memtable.FlushablePartitionSet<P extends Partition>, Memtable.LastCommitLogPosition, Memtable.MemoryUsage, Memtable.Owner -
Field Summary
FieldsFields inherited from class org.apache.cassandra.db.memtable.AbstractShardedMemtable
boundaries, SHARDED_MEMTABLE_CONFIG_OBJECT_NAME, SHARDS_OPTIONFields inherited from class org.apache.cassandra.db.memtable.AbstractAllocatorMemtable
allocator, initialComparator, initialFactory, MEMORY_POOL, ownerFields inherited from class org.apache.cassandra.db.memtable.AbstractMemtable
columnsCollector, currentOperations, metadata, minLocalDeletionTime, minTimestamp, statsCollectorFields inherited from interface org.apache.cassandra.db.memtable.Memtable
NO_MIN_TIMESTAMP -
Method Summary
Modifier and TypeMethodDescriptionstatic org.apache.cassandra.db.memtable.ShardedSkipListMemtable.FactorygetFlushSet(PartitionPosition from, PartitionPosition to) Get the collection of data between the given partition boundaries in a form suitable for flushing.longTechnically we should scatter gather on all the core threads because the size in following calls are not using volatile variables, but for metrics purpose this should be good enough.longMinimum local deletion time in the memtablelongReturns the minTS if one available, otherwise NO_MIN_TIMESTAMP.booleanisClean()True if the memtable contains no datalongNumber of "operations" (in the sense defined inPartitionUpdate.operationCount()) the memtable has executed.longNumber of partitions stored in the memtablepartitionIterator(ColumnFilter columnFilter, DataRange dataRange, SSTableReadsListener readsListener) Returns a partition iterator for the given data range.longput(PartitionUpdate update, UpdateTransaction indexer, OpOrder.Group opGroup) Should only be called by ColumnFamilyStore.apply via Keyspace.apply, which supplies the appropriate OpOrdering.rowIterator(DecoratedKey key) rowIterator(DecoratedKey key, Slices slices, ColumnFilter selectedColumns, boolean reversed, SSTableReadsListener listener) Returns a row iterator for the given partition, applying the specified row and column filters.Methods inherited from class org.apache.cassandra.db.memtable.AbstractShardedMemtable
getDefaultShardCountMethods inherited from class org.apache.cassandra.db.memtable.AbstractAllocatorMemtable
addMemoryUsageTo, createMemtableAllocatorPoolInternal, discard, flushLargestMemtable, getAllocator, localRangesUpdated, markExtraOffHeapUsed, markExtraOnHeapUsed, metadataUpdated, performSnapshot, shouldSwitch, switchOut, toStringMethods inherited from class org.apache.cassandra.db.memtable.AbstractMemtableWithCommitlog
accepts, getApproximateCommitLogLowerBound, getCommitLogLowerBound, getFinalCommitLogUpperBound, mayContainDataBeforeMethods inherited from class org.apache.cassandra.db.memtable.AbstractMemtable
getFlushTransaction, metadata, setFlushTransaction, updateMin, updateMinMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface org.apache.cassandra.db.CellSourceIdentifier
isEqualSource
-
Field Details
-
LOCKING_OPTION
- See Also:
-
-
Method Details
-
isClean
public boolean isClean()Description copied from interface:MemtableTrue if the memtable contains no data -
put
Should only be called by ColumnFamilyStore.apply via Keyspace.apply, which supplies the appropriate OpOrdering. commitLogSegmentPosition should only be null if this is a secondary index, in which case it is *expected* to be null- Parameters:
update- the partition update, may be a new partition or an update to an existing oneindexer- receives information about the update's effectopGroup- write operation group, used to permit the operation to complete if it is needed to complete a flush to free space.- Returns:
- the smallest timestamp delta between corresponding rows from existing and update. A
timestamp delta being computed as the difference between the cells and DeletionTimes from any existing partition
and those in
update. See CASSANDRA-7979.
-
getLiveDataSize
public long getLiveDataSize()Technically we should scatter gather on all the core threads because the size in following calls are not using volatile variables, but for metrics purpose this should be good enough. -
operationCount
public long operationCount()Description copied from interface:MemtableNumber of "operations" (in the sense defined inPartitionUpdate.operationCount()) the memtable has executed.- Specified by:
operationCountin interfaceMemtable- Overrides:
operationCountin classAbstractMemtable
-
partitionCount
public long partitionCount()Description copied from interface:MemtableNumber of partitions stored in the memtable -
getMinTimestamp
public long getMinTimestamp()Returns the minTS if one available, otherwise NO_MIN_TIMESTAMP. EncodingStats uses a synthetic epoch TS at 2015. We don't want to leak that (CASSANDRA-18118) so we return NO_MIN_TIMESTAMP instead.- Specified by:
getMinTimestampin interfaceUnfilteredSource- Overrides:
getMinTimestampin classAbstractMemtable- Returns:
- The minTS or NO_MIN_TIMESTAMP if none available
-
getMinLocalDeletionTime
public long getMinLocalDeletionTime()Description copied from interface:UnfilteredSourceMinimum local deletion time in the memtable- Specified by:
getMinLocalDeletionTimein interfaceUnfilteredSource- Overrides:
getMinLocalDeletionTimein classAbstractMemtable
-
partitionIterator
public ShardedSkipListMemtable.MemtableUnfilteredPartitionIterator partitionIterator(ColumnFilter columnFilter, DataRange dataRange, SSTableReadsListener readsListener) Description copied from interface:UnfilteredSourceReturns a partition iterator for the given data range.- Parameters:
columnFilter- filter to apply to all returned partitionsdataRange- the partition and clustering range queriedreadsListener- a listener used to handle internal read events
-
rowIterator
public UnfilteredRowIterator rowIterator(DecoratedKey key, Slices slices, ColumnFilter selectedColumns, boolean reversed, SSTableReadsListener listener) Description copied from interface:UnfilteredSourceReturns a row iterator for the given partition, applying the specified row and column filters.- Parameters:
key- the partition keyslices- the row ranges to returnselectedColumns- filter to apply to all returned partitionsreversed- true if the content should be returned in reverse orderlistener- a listener used to handle internal read events
-
rowIterator
-
getFlushSet
public Memtable.FlushablePartitionSet<AtomicBTreePartition> getFlushSet(PartitionPosition from, PartitionPosition to) Description copied from interface:MemtableGet the collection of data between the given partition boundaries in a form suitable for flushing. -
factory
-