public abstract class ReadCommand extends MonitorableImpl implements ReadQuery
This contains all the informations needed to do a local read.
Modifier and Type | Class and Description |
---|---|
protected class |
ReadCommand.CheckForAbort |
protected static class |
ReadCommand.Kind |
protected static class |
ReadCommand.SelectionDeserializer |
Modifier and Type | Field and Description |
---|---|
static IVersionedSerializer<ReadCommand> |
legacyPagedRangeCommandSerializer |
static IVersionedSerializer<ReadCommand> |
legacyRangeSliceCommandSerializer |
static IVersionedSerializer<ReadCommand> |
legacyReadCommandSerializer |
protected static org.slf4j.Logger |
logger |
static IVersionedSerializer<ReadCommand> |
pagedRangeSerializer |
static IVersionedSerializer<ReadCommand> |
rangeSliceSerializer |
static IVersionedSerializer<ReadCommand> |
readSerializer |
static IVersionedSerializer<ReadCommand> |
serializer |
Modifier | Constructor and Description |
---|---|
protected |
ReadCommand(ReadCommand.Kind kind,
boolean isDigestQuery,
int digestVersion,
boolean isForThrift,
CFMetaData metadata,
int nowInSec,
ColumnFilter columnFilter,
RowFilter rowFilter,
DataLimits limits,
IndexMetadata index) |
Modifier and Type | Method and Description |
---|---|
protected abstract void |
appendCQLWhereClause(java.lang.StringBuilder sb) |
abstract ClusteringIndexFilter |
clusteringIndexFilter(DecoratedKey key)
The clustering index filter this command to use for the provided key.
|
ColumnFilter |
columnFilter()
A filter on which (non-PK) columns must be returned by the query.
|
abstract ReadCommand |
copy()
Returns a copy of this command.
|
abstract ReadCommand |
copyAsDigestQuery()
Returns a copy of this command with isDigestQuery set to true.
|
abstract MessageOut<ReadCommand> |
createMessage(int version)
Creates a message for this command.
|
ReadResponse |
createResponse(UnfilteredPartitionIterator iterator) |
int |
digestVersion()
If the query is a digest one, the requested digest version.
|
PartitionIterator |
executeInternal(ReadExecutionController controller)
Execute the query for internal queries (that is, it basically executes the query locally).
|
UnfilteredPartitionIterator |
executeLocally(ReadExecutionController executionController)
Executes this command on the local host.
|
ReadExecutionController |
executionController()
Starts a new read operation.
|
Index |
getIndex(ColumnFamilyStore cfs) |
abstract long |
getTimeout()
The configured timeout for this command.
|
IndexMetadata |
indexMetadata()
Index (metadata) chosen for this query.
|
boolean |
isDigestQuery()
Whether this query is a digest one or not.
|
boolean |
isForThrift()
Whether this query is for thrift or not.
|
abstract boolean |
isLimitedToOnePartition() |
DataLimits |
limits()
The limits set on this query.
|
void |
maybeValidateIndex()
If the index manager for the CFS determines that there's an applicable
2i that can be used to execute this command, call its (optional)
validation method to check that nothing in this command's parameters
violates the implementation specific validation rules.
|
CFMetaData |
metadata()
The metadata for the table queried.
|
java.lang.String |
name() |
int |
nowInSec()
The time in seconds to use as "now" for this query.
|
protected abstract int |
oldestUnrepairedTombstone() |
protected abstract UnfilteredPartitionIterator |
queryStorage(ColumnFamilyStore cfs,
ReadExecutionController executionController) |
protected abstract void |
recordLatency(TableMetrics metric,
long latencyNanos) |
RowFilter |
rowFilter()
Filters/Resrictions on CQL rows.
|
protected abstract long |
selectionSerializedSize(int version) |
protected abstract void |
serializeSelection(DataOutputPlus out,
int version) |
ReadCommand |
setDigestVersion(int digestVersion)
Sets the digest version, for when digest for that command is requested.
|
java.lang.String |
toCQLString()
Recreate the CQL string corresponding to this query.
|
protected UnfilteredPartitionIterator |
withoutPurgeableTombstones(UnfilteredPartitionIterator iterator,
ColumnFamilyStore cfs) |
protected UnfilteredPartitionIterator |
withStateTracking(UnfilteredPartitionIterator iter) |
abstract ReadCommand |
withUpdatedLimit(DataLimits newLimits)
Creates a new
ReadCommand instance with new limits. |
abort, complete, constructionTime, isAborted, isCompleted, isCrossNode, isInProgress, isSlow, setMonitoringTime, slowTimeout, timeout
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
execute, getPager, selectsClustering, selectsFullPartition, selectsKey
protected static final org.slf4j.Logger logger
public static final IVersionedSerializer<ReadCommand> serializer
public static final IVersionedSerializer<ReadCommand> readSerializer
public static final IVersionedSerializer<ReadCommand> rangeSliceSerializer
public static final IVersionedSerializer<ReadCommand> pagedRangeSerializer
public static final IVersionedSerializer<ReadCommand> legacyRangeSliceCommandSerializer
public static final IVersionedSerializer<ReadCommand> legacyPagedRangeCommandSerializer
public static final IVersionedSerializer<ReadCommand> legacyReadCommandSerializer
protected ReadCommand(ReadCommand.Kind kind, boolean isDigestQuery, int digestVersion, boolean isForThrift, CFMetaData metadata, int nowInSec, ColumnFilter columnFilter, RowFilter rowFilter, DataLimits limits, IndexMetadata index)
protected abstract void serializeSelection(DataOutputPlus out, int version) throws java.io.IOException
java.io.IOException
protected abstract long selectionSerializedSize(int version)
public abstract boolean isLimitedToOnePartition()
public abstract ReadCommand withUpdatedLimit(DataLimits newLimits)
ReadCommand
instance with new limits.newLimits
- the new limitsReadCommand
with the updated limitspublic CFMetaData metadata()
public int nowInSec()
We use the same time as "now" for the whole query to avoid considering different values as expired during the query, which would be buggy (would throw of counting amongst other things).
public abstract long getTimeout()
public ColumnFilter columnFilter()
public RowFilter rowFilter()
This contains the restrictions that are not directly handled by the
ClusteringIndexFilter
. More specifically, this includes any non-PK column
restrictions and can include some PK columns restrictions when those can't be
satisfied entirely by the clustering index filter (because not all clustering columns
have been restricted for instance). If there is 2ndary indexes on the table,
one of this restriction might be handled by a 2ndary index.
public DataLimits limits()
public boolean isDigestQuery()
public int digestVersion()
public ReadCommand setDigestVersion(int digestVersion)
Note that we allow setting this independently of setting the command as a digest query as this allows us to use the command as a carrier of the digest version even if we only call setIsDigestQuery on some copy of it.
digestVersion
- the version for the digest is this command is used for digest query..public boolean isForThrift()
@Nullable public IndexMetadata indexMetadata()
public abstract ClusteringIndexFilter clusteringIndexFilter(DecoratedKey key)
Note that that method should only be called on a key actually queried by this command and in practice, this will almost always return the same filter, but for the sake of paging, the filter on the first key of a range command might be slightly different.
key
- a partition key queried by this command.ClusteringIndexFilter
to use for the partition of key key
.public abstract ReadCommand copy()
public abstract ReadCommand copyAsDigestQuery()
protected abstract UnfilteredPartitionIterator queryStorage(ColumnFamilyStore cfs, ReadExecutionController executionController)
protected abstract int oldestUnrepairedTombstone()
public ReadResponse createResponse(UnfilteredPartitionIterator iterator)
public Index getIndex(ColumnFamilyStore cfs)
public void maybeValidateIndex()
public UnfilteredPartitionIterator executeLocally(ReadExecutionController executionController)
executeLocally
in interface ReadQuery
executionController
- the execution controller spanning this commandprotected abstract void recordLatency(TableMetrics metric, long latencyNanos)
public PartitionIterator executeInternal(ReadExecutionController controller)
ReadQuery
executeInternal
in interface ReadQuery
controller
- the ReadExecutionController
protecting the read.public ReadExecutionController executionController()
ReadQuery
This must be called before executeInternal
and passed to it to protect the read.
The returned object must be closed on all path and it is thus strongly advised to
use it in a try-with-ressource construction.
executionController
in interface ReadQuery
ReadQuery
.protected UnfilteredPartitionIterator withStateTracking(UnfilteredPartitionIterator iter)
public abstract MessageOut<ReadCommand> createMessage(int version)
protected abstract void appendCQLWhereClause(java.lang.StringBuilder sb)
protected UnfilteredPartitionIterator withoutPurgeableTombstones(UnfilteredPartitionIterator iterator, ColumnFamilyStore cfs)
public java.lang.String toCQLString()
Note that in general the returned string will not be exactly the original user string, first because there isn't always a single syntax for a given query, but also because we don't have all the information needed (we know the non-PK columns queried but not the PK ones as internally we query them all). So this shouldn't be relied too strongly, but this should be good enough for debugging purpose which is what this is for.
public java.lang.String name()
name
in interface Monitorable
Copyright © 2019 The Apache Software Foundation