As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Keyset API

Wrap representation of Spanner keys / ranges.

class google.cloud.spanner_v1.keyset.KeyRange(start_open=None, start_closed=None, end_open=None, end_closed=None)[source]

Bases: object

Identify range of table rows via start / end points.

Specify either a start_open or start_closed key, or defaults to start_closed = []. Specify either an end_open or end_closed key, or defaults to end_closed = []. However, at least one key has to be specified. If no keys are specified, ValueError is raised.

Parameters

  • start_open (list of scalars) – keys identifying start of range (this key excluded)

  • start_closed (list of scalars) – keys identifying start of range (this key included)

  • end_open (list of scalars) – keys identifying end of range (this key excluded)

  • end_closed (list of scalars) – keys identifying end of range (this key included)

Raises

ValueError – if no keys are specified

__eq__(other)[source]

Compare by serialized state.

class google.cloud.spanner_v1.keyset.KeySet(keys=(), ranges=(), all_=False)[source]

Bases: object

Identify table rows via keys / ranges.

Parameters

  • keys (list of list of scalars) – keys identifying individual rows within a table.

  • ranges (list of KeyRange) – ranges identifying rows within a table.

  • all (boolean) – if True, identify all rows within a table

__eq__(other)[source]

Compare by serialized state.