Row Set

User-friendly container for Google Cloud Bigtable RowSet

class google.cloud.bigtable.row_set.RowRange(start_key=None, end_key=None, start_inclusive=True, end_inclusive=False)

Bases: object

Convenience wrapper of google.bigtable.v2.RowRange

• Parameters

  • start_key (bytes) – (Optional) Start key of the row range. If left empty, will be interpreted as the empty string.

  • end_key (bytes) – (Optional) End key of the row range. If left empty, will be interpreted as the empty string and range will be unbounded on the high end.

  • start_inclusive (bool) – (Optional) Whether the start_key should be considered inclusive. The default is True (inclusive).

  • end_inclusive (bool) – (Optional) Whether the end_key should be considered inclusive. The default is False (exclusive).

get_range_kwargs()

Convert row range object to dict which can be passed to google.bigtable.v2.RowRange add method.

class google.cloud.bigtable.row_set.RowSet()

Bases: object

Convenience wrapper of google.bigtable.v2.RowSet

Useful for creating a set of row keys and row ranges, which can be passed to read_rows method of class:.Table.read_rows.

add_row_key(row_key)

Add row key to row_keys list.

For example:

from google.cloud.bigtable import Client
from google.cloud.bigtable.row_set import RowSet
client = Client(admin=True)
instance = client.instance(INSTANCE_ID)
table = instance.table(TABLE_ID)
row_set = RowSet()
row_set.add_row_key(b"row_key_5")

• Parameters

  row_key (bytes) – The key of a row to read

add_row_range(row_range)

Add row_range to row_ranges list.

For example:

from google.cloud.bigtable import Client
from google.cloud.bigtable.row_set import RowSet
from google.cloud.bigtable.row_set import RowRange
client = Client(admin=True)
instance = client.instance(INSTANCE_ID)
table = instance.table(TABLE_ID)
row_set = RowSet()
row_set.add_row_range(RowRange(start_key=b"row_key_3", end_key=b"row_key_7"))

• Parameters

  row_range (class:RowRange) – The row range object having start and end key

add_row_range_from_keys(start_key=None, end_key=None, start_inclusive=True, end_inclusive=False)

Add row range to row_ranges list from the row keys

For example:

from google.cloud.bigtable import Client
from google.cloud.bigtable.row_set import RowSet
client = Client(admin=True)
instance = client.instance(INSTANCE_ID)
table = instance.table(TABLE_ID)
row_set = RowSet()
row_set.add_row_range_from_keys(start_key=b"row_key_3", end_key=b"row_key_7")

• Parameters

  • start_key (bytes) – (Optional) Start key of the row range. If left empty, will be interpreted as the empty string.

  • end_key (bytes) – (Optional) End key of the row range. If left empty, will be interpreted as the empty string and range will be unbounded on the high end.

  • start_inclusive (bool) – (Optional) Whether the start_key should be considered inclusive. The default is True (inclusive).

  • end_inclusive (bool) – (Optional) Whether the end_key should be considered inclusive. The default is False (exclusive).

add_row_range_with_prefix(row_key_prefix)

Add row range to row_ranges list that start with the row_key_prefix from the row keys

For example:

 from google.cloud.bigtable import Client
 from google.cloud.bigtable.row_set import RowSet
 client = Client(admin=True)
 instance = client.instance(INSTANCE_ID)
 table = instance.table(TABLE_ID)
 row_set = RowSet()
 row_set.add_row_range_with_prefix("row")

• Parameters

  row_key_prefix (str) – To retrieve all rows that start with this row key prefix. Prefix cannot be zero length.