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.

Custom Exceptions

exception google.cloud.bigtable.data.exceptions.FailedMutationEntryError(failed_idx: int | None, failed_mutation_entry: RowMutationEntry, cause: Exception)

Bases: Exception

Represents a single failed RowMutationEntry in a bulk_mutate_rows request. A collection of FailedMutationEntryErrors will be raised in a MutationsExceptionGroup

exception google.cloud.bigtable.data.exceptions.FailedQueryShardError(failed_index: int, failed_query: 'ReadRowsQuery' | dict[str, Any], cause: Exception)

Bases: Exception

Represents an individual failed query in a sharded read rows operation

exception google.cloud.bigtable.data.exceptions.InvalidChunk(message, errors=(), details=(), response=None, error_info=None)

Bases: google.api_core.exceptions.GoogleAPICallError

Exception raised to invalid chunk data from back-end.

exception google.cloud.bigtable.data.exceptions.InvalidExecuteQueryResponse(message, errors=(), details=(), response=None, error_info=None)

Bases: google.api_core.exceptions.GoogleAPICallError

Exception raised to invalid query response data from back-end.

exception google.cloud.bigtable.data.exceptions.MutationsExceptionGroup(excs: list[Exception], total_entries: int, message: str | None = None)

Bases: google.cloud.bigtable.data.exceptions._BigtableExceptionGroup

Represents one or more exceptions that occur during a bulk mutation operation

Exceptions will typically be of type FailedMutationEntryError, but other exceptions may be included if they are raised during the mutation operation

Parameters

• excs – the exceptions in the group

• total_entries – the total number of entries attempted, successful or not

• message – the message for the exception group. If None, a default message will be generated

static __new__(cls, excs: list[Exception], total_entries: int, message: str | None = None)

Parameters

• excs – the exceptions in the group

• total_entries – the total number of entries attempted, successful or not

• message – the message for the exception group. If None, a default message

Returns

the new instance

Return type

MutationsExceptionGroup

classmethod from_truncated_lists(first_list: list[Exception], last_list: list[Exception], total_excs: int, entry_count: int) → google.cloud.bigtable.data.exceptions.MutationsExceptionGroup

Create a MutationsExceptionGroup from two lists of exceptions, representing a larger set that has been truncated. The MutationsExceptionGroup will contain the union of the two lists as sub-exceptions, and the error message describe the number of exceptions that were truncated.

Parameters

• first_list – the set of oldest exceptions to add to the ExceptionGroup

• last_list – the set of newest exceptions to add to the ExceptionGroup

• total_excs – the total number of exceptions associated with the request Should be len(first_list) + len(last_list) + number of dropped exceptions in the middle

• entry_count – the total number of entries attempted, successful or not

Returns

the new instance

Return type

MutationsExceptionGroup

exception google.cloud.bigtable.data.exceptions.ParameterTypeInferenceFailed

Bases: ValueError

Exception raised when query parameter types were not provided and cannot be inferred.

exception google.cloud.bigtable.data.exceptions.RetryExceptionGroup(excs: list[Exception])

Bases: google.cloud.bigtable.data.exceptions._BigtableExceptionGroup

Represents one or more exceptions that occur during a retryable operation

exception google.cloud.bigtable.data.exceptions.ShardedReadRowsExceptionGroup(excs: list[google.cloud.bigtable.data.exceptions.FailedQueryShardError], succeeded: list[google.cloud.bigtable.data.row.Row], total_queries: int)

Bases: google.cloud.bigtable.data.exceptions._BigtableExceptionGroup

Represents one or more exceptions that occur during a sharded read rows operation