Mutations

class google.cloud.bigtable.data.mutations.DeleteAllFromFamily(family_to_delete: str)

Bases: google.cloud.bigtable.data.mutations.Mutation

Mutation to delete all cells from a column family.

  • Parameters

    family_to_delete – The name of the column family to delete.

class google.cloud.bigtable.data.mutations.DeleteAllFromRow()

Bases: google.cloud.bigtable.data.mutations.Mutation

Mutation to delete all cells from a row.

class google.cloud.bigtable.data.mutations.DeleteRangeFromColumn(family: str, qualifier: bytes, start_timestamp_micros: Optional[int] = None, end_timestamp_micros: Optional[int] = None)

Bases: google.cloud.bigtable.data.mutations.Mutation

Mutation to delete a range of cells from a column.

  • Parameters

    • family – The name of the column family. qualifier: The column qualifier.

    • start_timestamp_micros – The start timestamp of the range to delete. None represents 0. Defaults to None.

    • end_timestamp_micros – The end timestamp of the range to delete. None represents infinity. Defaults to None.

  • Raises

    ValueError – If start_timestamp_micros is greater than end_timestamp_micros.

class google.cloud.bigtable.data.mutations.Mutation()

Bases: abc.ABC

Abstract base class for mutations.

This class defines the interface for different types of mutations that can be applied to Bigtable rows.

_str_()

Return a string representation of the mutation.

  • Returns

    A string representation of the mutation.

  • Return type

    str

is_idempotent()

Check if the mutation is idempotent

Idempotent mutations can be safely retried on failure.

  • Returns

    True if the mutation is idempotent, False otherwise.

  • Return type

    bool

size()

Get the size of the mutation in bytes

  • Returns

    The size of the mutation in bytes.

  • Return type

    int

class google.cloud.bigtable.data.mutations.RowMutationEntry(row_key: bytes | str, mutations: google.cloud.bigtable.data.mutations.Mutation | list[google.cloud.bigtable.data.mutations.Mutation])

Bases: object

A single entry in a MutateRows request.

This class represents a set of mutations to apply to a specific row in a Bigtable table.

  • Parameters

    • row_key – The key of the row to mutate.

    • mutations – The mutation or list of mutations to apply to the row.

  • Raises

    ValueError – If mutations is empty or contains more than _MUTATE_ROWS_REQUEST_MUTATION_LIMIT mutations.

is_idempotent()

Check if all mutations in the entry are idempotent.

  • Returns

    True if all mutations in the entry are idempotent, False otherwise.

  • Return type

    bool

size()

Get the size of the mutation entry in bytes.

  • Returns

    The size of the mutation entry in bytes.

  • Return type

    int

class google.cloud.bigtable.data.mutations.SetCell(family: str, qualifier: bytes | str, new_value: bytes | str | int, timestamp_micros: Optional[int] = None)

Bases: google.cloud.bigtable.data.mutations.Mutation

Mutation to set the value of a cell.

  • Parameters

    • family – The name of the column family to which the new cell belongs.

    • qualifier – The column qualifier of the new cell.

    • new_value – The value of the new cell.

    • timestamp_micros – The timestamp of the new cell. If None, the current timestamp will be used. Timestamps will be sent with millisecond precision. Extra precision will be truncated. If -1, the server will assign a timestamp. Note that SetCell mutations with server-side timestamps are non-idempotent operations and will not be retried.

  • Raises

    • TypeError – If qualifier is not bytes or str.

    • TypeError – If new_value is not bytes, str, or int.

    • ValueError – If timestamp_micros is less than _SERVER_SIDE_TIMESTAMP.

is_idempotent()

Check if the mutation is idempotent

Idempotent mutations can be safely retried on failure.

  • Returns

    True if the mutation is idempotent, False otherwise.

  • Return type

    bool