Version latest

• 2.23.1 (latest)
• 2.23.0
• 2.22.0
• 2.21.0
• 2.20.0
• 2.19.0
• 2.18.1
• 2.17.0
• 2.16.0
• 2.15.0
• 2.14.1
• 2.13.2
• 2.12.0
• 2.11.3
• 2.10.1
• 2.9.0
• 2.8.1
• 2.7.1
• 2.6.0
• 2.5.2
• 2.4.0
• 2.3.3
• 2.2.0
• 2.1.0
• 2.0.0
• 1.7.3
• 1.6.1
• 1.5.1
• 1.4.0
• 1.3.0
• 1.2.1
• 1.1.0
• 1.0.0
• 0.34.0

Rows and Cells

class google.cloud.bigtable.data.row.Cell(value: bytes, row_key: bytes, family: str, qualifier: bytes | str, timestamp_micros: int, labels: Optional[list[str]] = None)

Bases: object

Model class for cell data

Does not represent all data contained in the cell, only data returned by a query. Expected to be read-only to users, and written by backend

Cell constructor

Cell objects are not intended to be constructed by users. They are returned by the Bigtable backend.

_eq_(other)

Implements == operator

_hash_()

Implements hash() function to fingerprint cell

_int_()

Allows casting cell to int Interprets value as a 64-bit big-endian signed integer, as expected by ReadModifyWrite increment rule

_lt_(other)

Implements < operator

_ne_(other)

Implements != operator

_repr_()

Returns a string representation of the cell

_str_()

Allows casting cell to str Prints encoded byte string, same as printing value directly.

class google.cloud.bigtable.data.row.Row(key: bytes, cells: list[google.cloud.bigtable.data.row.Cell])

Bases: object

Model class for row data returned from server

Does not represent all data contained in the row, only data returned by a query. Expected to be read-only to users, and written by backend

Can be indexed: cells = row[“family”, “qualifier”]

Initializes a Row object

Row objects are not intended to be created by users. They are returned by the Bigtable backend.

_contains_(item)

Implements in operator

Works for both cells in the internal list, and family or (family, qualifier) pairs associated with the cells

_eq_(other)

Implements == operator

_getitem_(index: str | tuple[str, bytes | str])

_getitem_(index: int)

_getitem_(index: slice)

Implements [] indexing

Supports indexing by family, (family, qualifier) pair, numerical index, and index slicing

_iter_()

Allow iterating over all cells in the row

_len_()

Implements len() operator

_ne_(other)

Implements != operator

_str_()

Human-readable string representation

{
  (family='fam', qualifier=b'col'): [b'value', (+1 more),],
  (family='fam', qualifier=b'col2'): [b'other'],
}

get_cells(family: Optional[str] = None, qualifier: Optional[Union[str, bytes]] = None)

Returns cells sorted in Bigtable native order:

* Family lexicographically ascending


* Qualifier ascending


* Timestamp in reverse chronological order

If family or qualifier not passed, will include all

Can also be accessed through indexing:

cells = row[“family”, “qualifier”]
cells = row[“family”]