Interface Index.Indexer

  • Enclosing interface:
    Index

    public static interface Index.Indexer
    Listener for processing events emitted during a single partition update. Instances of this are responsible for applying modifications to the index in response to a single update operation on a particular partition of the base table. That update may be generated by the normal write path, by iterating SSTables during streaming operations or when building or rebuilding an index from source. Updates also occur during compaction when multiple versions of a source partition from different SSTables are merged. Implementations should not make assumptions about resolution or filtering of the partition update being processed. That is to say that it is possible for an Indexer instance to receive notification of a PartitionDelete or RangeTombstones which shadow a Row it then receives via insertRow/updateRow. It is important to note that the only ordering guarantee made for the methods here is that the first call will be to begin() and the last call to finish(). The other methods may be called to process update events in any order. This can also include duplicate calls, in cases where a memtable partition is under contention from several updates. In that scenario, the same set of events may be delivered to the Indexer as memtable update which failed due to contention is re-applied.
    • Method Summary

      All Methods Instance Methods Default Methods 
      Modifier and Type Method Description
      default void begin()
      Notification of the start of a partition update.
      default void finish()
      Notification of the end of the partition update.
      default void insertRow​(Row row)
      Notification that a new row was inserted into the Memtable holding the partition.
      default void partitionDelete​(DeletionTime deletionTime)
      Notification of a top level partition delete.
      default void rangeTombstone​(RangeTombstone tombstone)
      Notification of a RangeTombstone.
      default void removeRow​(Row row)
      Notification that a row was removed from the partition.
      default void updateRow​(Row oldRowData, Row newRowData)
      Notification of a modification to a row in the base table's Memtable.
    • Method Detail

      • begin

        default void begin()
        Notification of the start of a partition update. This event always occurs before any other during the update.
      • partitionDelete

        default void partitionDelete​(DeletionTime deletionTime)
        Notification of a top level partition delete.
      • rangeTombstone

        default void rangeTombstone​(RangeTombstone tombstone)
        Notification of a RangeTombstone. An update of a single partition may contain multiple RangeTombstones, and a notification will be passed for each of them.
      • insertRow

        default void insertRow​(Row row)
        Notification that a new row was inserted into the Memtable holding the partition. This only implies that the inserted row was not already present in the Memtable, it *does not* guarantee that the row does not exist in an SSTable, potentially with additional column data.
        Parameters:
        row - the Row being inserted into the base table's Memtable.
      • updateRow

        default void updateRow​(Row oldRowData,
                               Row newRowData)
        Notification of a modification to a row in the base table's Memtable. This is allow an Index implementation to clean up entries for base data which is never flushed to disk (and so will not be purged during compaction). It's important to note that the old and new rows supplied here may not represent the totality of the data for the Row with this particular Clustering. There may be additional column data in SSTables which is not present in either the old or new row, so implementations should be aware of that. The supplied rows contain only column data which has actually been updated. oldRowData contains only the columns which have been removed from the Row's representation in the Memtable, while newRowData includes only new columns which were not previously present. Any column data which is unchanged by the update is not included.
        Parameters:
        oldRowData - data that was present in existing row and which has been removed from the base table's Memtable
        newRowData - data that was not present in the existing row and is being inserted into the base table's Memtable
      • removeRow

        default void removeRow​(Row row)
        Notification that a row was removed from the partition. Note that this is only called as part of either a compaction or a cleanup. This context is indicated by the TransactionType supplied to the indexerFor method. As with updateRow, it cannot be guaranteed that all data belonging to the Clustering of the supplied Row has been removed (although in the case of a cleanup, that is the ultimate intention). There may be data for the same row in other SSTables, so in this case Indexer implementations should *not* assume that all traces of the row have been removed. In particular, it is not safe to assert that all values associated with the Row's Clustering have been deleted, so implementations which index primary key columns should not purge those entries from their indexes.
        Parameters:
        row - data being removed from the base table
      • finish

        default void finish()
        Notification of the end of the partition update. This event always occurs after all others for the particular update.