Struct Mutation 

pub struct Mutation {
    pub table: TableId,
    pub partition_key: PartitionKey,
    pub clustering_key: Option<ClusteringKey>,
    pub operations: Vec<CellOperation>,
    pub timestamp_micros: i64,
    pub ttl_seconds: Option<u32>,
    pub partition_tombstone: Option<PartitionTombstone>,
    pub range_tombstones: Vec<RangeTombstone>,
}

A mutation represents a write operation (INSERT, UPDATE, DELETE)

This is the fundamental unit of write operations in CQLite, corresponding to a single CQL INSERT/UPDATE/DELETE statement. Each mutation targets a specific row (identified by partition key + optional clustering key) and contains one or more cell operations.

Tombstone Support (M5.2)

Mutations can represent various deletion types:

• Cell tombstone: CellOperation::Delete for single column
• Row tombstone: CellOperation::DeleteRow for entire row
• Range tombstone: range_tombstones field for clustering key ranges
• Partition tombstone: partition_tombstone field for entire partition

Fields

table: TableId

Target table

partition_key: PartitionKey

Partition key values

clustering_key: Option<ClusteringKey>

Clustering key values (None for tables without clustering keys)

operations: Vec<CellOperation>

Cell-level operations (writes or deletes)

timestamp_micros: i64

Timestamp in microseconds since Unix epoch

ttl_seconds: Option<u32>

Time-to-live in seconds applied to all cells in this mutation (None = no expiration).

This is set by USING TTL in CQL statements and applies uniformly to all Write operations. For per-column TTL, use CellOperation::WriteWithTtl in the operations list instead.

partition_tombstone: Option<PartitionTombstone>

Partition tombstone (deletes entire partition)

range_tombstones: Vec<RangeTombstone>

Range tombstones (delete clustering key ranges within partition)

Implementations

impl Mutation

pub fn new( table: TableId, partition_key: PartitionKey, clustering_key: Option<ClusteringKey>, operations: Vec<CellOperation>, timestamp_micros: i64, ttl_seconds: Option<u32>, ) -> Self

Create a new mutation

pub fn decorated_key(&self, schema: &TableSchema) -> Result<DecoratedKey>

Get the decorated key for this mutation (token + raw bytes)

Trait Implementations

impl Clone for Mutation

fn clone(&self) -> Mutation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Mutation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Mutation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Mutation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.