Custom Exceptions

exception google.cloud.bigtable.data.exceptions.EarlyMetadataCallError()

Bases: RuntimeError

Execption raised when metadata is request from an ExecuteQueryIterator before the first row has been read, or the query has completed

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: Optional [ str ] = 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: Optional [ str ] = 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 )

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