(Optional) Default options to use for all transactions.
project
strorunicode
(Optional) The ID of the project which owns the instances, tables and data. If not provided, will attempt to determine from the environment.
credentials
Credentialsor :data:NoneType
(Optional) The authorization credentials to attach to requests. These credentials identify this application to the service. If none are specified, the client will attempt to ascertain the credentials from the environment.
client_info
google.api_core.gapic_v1.client_info.ClientInfo
(Optional) The client info used to send a user-agent string along with API requests. IfNone, then default info will be used. Generally, you only need to set this if you're developing your own library or partner tool.
(Optional) Query optimizer configuration to use for the given query. If a dict is provided, it must be of the same form as the protobuf messageQueryOptions
route_to_leader_enabled
boolean
(Optional) Default True. Set route_to_leader_enabled as False to disable leader aware routing. Disabling leader aware routing would route all requests in RW/PDML transactions to the closest region.
directed_read_options
DirectedReadOptionsordict
(Optional) Client options used to set the directed_read_options for all ReadRequests and ExecuteSqlRequests that indicates which replicas or regions should be used for non-transactional reads or queries.
observability_options
dict (str -> any) or None
(Optional) the configuration to control the tracer's behavior. tracer_provider is the injected tracer provider enable_extended_tracing: :type:boolean when set to true will allow for spans that issue SQL statements to be annotated with SQL. DefaultTrue, please set it toFalseto turn it off or you can use the environment variableSPANNER_ENABLE_EXTENDED_TRACING=to control it. enable_end_to_end_tracing: :type:boolean when set to true will allow for spans from Spanner server side. DefaultFalse, please set it toTrueto turn it on or you can use the environment variableSPANNER_ENABLE_END_TO_END_TRACING=to control it.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Module client (3.57.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.57.0 (latest)](/python/docs/reference/spanner/latest/google.cloud.spanner_v1.client)\n- [3.56.0](/python/docs/reference/spanner/3.56.0/google.cloud.spanner_v1.client)\n- [3.55.0](/python/docs/reference/spanner/3.55.0/google.cloud.spanner_v1.client)\n- [3.54.0](/python/docs/reference/spanner/3.54.0/google.cloud.spanner_v1.client)\n- [3.53.0](/python/docs/reference/spanner/3.53.0/google.cloud.spanner_v1.client)\n- [3.52.0](/python/docs/reference/spanner/3.52.0/google.cloud.spanner_v1.client)\n- [3.51.0](/python/docs/reference/spanner/3.51.0/google.cloud.spanner_v1.client)\n- [3.50.1](/python/docs/reference/spanner/3.50.1/google.cloud.spanner_v1.client)\n- [3.46.0](/python/docs/reference/spanner/3.46.0/google.cloud.spanner_v1.client)\n- [3.45.0](/python/docs/reference/spanner/3.45.0/google.cloud.spanner_v1.client)\n- [3.44.0](/python/docs/reference/spanner/3.44.0/google.cloud.spanner_v1.client)\n- [3.43.0](/python/docs/reference/spanner/3.43.0/google.cloud.spanner_v1.client)\n- [3.42.0](/python/docs/reference/spanner/3.42.0/google.cloud.spanner_v1.client)\n- [3.41.0](/python/docs/reference/spanner/3.41.0/google.cloud.spanner_v1.client)\n- [3.40.1](/python/docs/reference/spanner/3.40.1/google.cloud.spanner_v1.client)\n- [3.39.0](/python/docs/reference/spanner/3.39.0/google.cloud.spanner_v1.client)\n- [3.38.0](/python/docs/reference/spanner/3.38.0/google.cloud.spanner_v1.client)\n- [3.37.0](/python/docs/reference/spanner/3.37.0/google.cloud.spanner_v1.client)\n- [3.36.0](/python/docs/reference/spanner/3.36.0/google.cloud.spanner_v1.client)\n- [3.35.1](/python/docs/reference/spanner/3.35.1/google.cloud.spanner_v1.client)\n- [3.34.0](/python/docs/reference/spanner/3.34.0/google.cloud.spanner_v1.client)\n- [3.33.0](/python/docs/reference/spanner/3.33.0/google.cloud.spanner_v1.client)\n- [3.32.0](/python/docs/reference/spanner/3.32.0/google.cloud.spanner_v1.client)\n- [3.31.0](/python/docs/reference/spanner/3.31.0/google.cloud.spanner_v1.client)\n- [3.30.0](/python/docs/reference/spanner/3.30.0/google.cloud.spanner_v1.client)\n- [3.29.0](/python/docs/reference/spanner/3.29.0/google.cloud.spanner_v1.client)\n- [3.28.0](/python/docs/reference/spanner/3.28.0/google.cloud.spanner_v1.client)\n- [3.27.1](/python/docs/reference/spanner/3.27.1/google.cloud.spanner_v1.client)\n- [3.26.0](/python/docs/reference/spanner/3.26.0/google.cloud.spanner_v1.client)\n- [3.25.0](/python/docs/reference/spanner/3.25.0/google.cloud.spanner_v1.client)\n- [3.24.0](/python/docs/reference/spanner/3.24.0/google.cloud.spanner_v1.client)\n- [3.23.0](/python/docs/reference/spanner/3.23.0/google.cloud.spanner_v1.client)\n- [3.22.2](/python/docs/reference/spanner/3.22.2/google.cloud.spanner_v1.client)\n- [3.21.0](/python/docs/reference/spanner/3.21.0/google.cloud.spanner_v1.client)\n- [3.20.0](/python/docs/reference/spanner/3.20.0/google.cloud.spanner_v1.client)\n- [3.19.0](/python/docs/reference/spanner/3.19.0/google.cloud.spanner_v1.client)\n- [3.18.0](/python/docs/reference/spanner/3.18.0/google.cloud.spanner_v1.client)\n- [3.17.0](/python/docs/reference/spanner/3.17.0/google.cloud.spanner_v1.client)\n- [3.16.0](/python/docs/reference/spanner/3.16.0/google.cloud.spanner_v1.client)\n- [3.15.1](/python/docs/reference/spanner/3.15.1/google.cloud.spanner_v1.client)\n- [3.14.1](/python/docs/reference/spanner/3.14.1/google.cloud.spanner_v1.client)\n- [3.13.0](/python/docs/reference/spanner/3.13.0/google.cloud.spanner_v1.client)\n- [3.12.1](/python/docs/reference/spanner/3.12.1/google.cloud.spanner_v1.client)\n- [3.11.1](/python/docs/reference/spanner/3.11.1/google.cloud.spanner_v1.client)\n- [3.10.0](/python/docs/reference/spanner/3.10.0/google.cloud.spanner_v1.client)\n- [3.9.0](/python/docs/reference/spanner/3.9.0/google.cloud.spanner_v1.client)\n- [3.8.0](/python/docs/reference/spanner/3.8.0/google.cloud.spanner_v1.client)\n- [3.7.0](/python/docs/reference/spanner/3.7.0/google.cloud.spanner_v1.client)\n- [3.6.0](/python/docs/reference/spanner/3.6.0/google.cloud.spanner_v1.client)\n- [3.5.0](/python/docs/reference/spanner/3.5.0/google.cloud.spanner_v1.client)\n- [3.4.0](/python/docs/reference/spanner/3.4.0/google.cloud.spanner_v1.client)\n- [3.3.0](/python/docs/reference/spanner/3.3.0/google.cloud.spanner_v1.client)\n- [3.2.0](/python/docs/reference/spanner/3.2.0/google.cloud.spanner_v1.client)\n- [3.1.0](/python/docs/reference/spanner/3.1.0/google.cloud.spanner_v1.client)\n- [3.0.0](/python/docs/reference/spanner/3.0.0/google.cloud.spanner_v1.client)\n- [2.1.1](/python/docs/reference/spanner/2.1.1/google.cloud.spanner_v1.client)\n- [2.0.0](/python/docs/reference/spanner/2.0.0/google.cloud.spanner_v1.client)\n- [1.19.3](/python/docs/reference/spanner/1.19.3/google.cloud.spanner_v1.client)\n- [1.18.0](/python/docs/reference/spanner/1.18.0/google.cloud.spanner_v1.client)\n- [1.17.1](/python/docs/reference/spanner/1.17.1/google.cloud.spanner_v1.client)\n- [1.16.0](/python/docs/reference/spanner/1.16.0/google.cloud.spanner_v1.client)\n- [1.15.1](/python/docs/reference/spanner/1.15.1/google.cloud.spanner_v1.client)\n- [1.14.0](/python/docs/reference/spanner/1.14.0/google.cloud.spanner_v1.client)\n- [1.13.0](/python/docs/reference/spanner/1.13.0/google.cloud.spanner_v1.client)\n- [1.12.0](/python/docs/reference/spanner/1.12.0/google.cloud.spanner_v1.client)\n- [1.11.0](/python/docs/reference/spanner/1.11.0/google.cloud.spanner_v1.client)\n- [1.10.0](/python/docs/reference/spanner/1.10.0/google.cloud.spanner_v1.client) \nParent client for calling the Cloud Spanner API.\n\nThis is the base from which all interactions with the API occur.\n\nIn the hierarchy of API concepts\n\n- a [Client](/python/docs/reference/spanner/latest/google.cloud.spanner_v1.client.Client) owns an [Instance](/python/docs/reference/spanner/latest/google.cloud.spanner_v1.instance.Instance)\n- a [Instance](/python/docs/reference/spanner/latest/google.cloud.spanner_v1.instance.Instance) owns a [Database](/python/docs/reference/spanner/latest/google.cloud.spanner_v1.database.Database)\n\nClasses\n-------\n\n### [Client](/python/docs/reference/spanner/latest/google.cloud.spanner_v1.client.Client)\n\n Client(project=None, credentials=None, client_info=\u003cgoogle.api_core.gapic_v1.client_info.ClientInfo object\u003e, client_options=None, query_options=None, route_to_leader_enabled=True, directed_read_options=None, observability_options=None, default_transaction_options: typing.Optional[google.cloud.spanner_v1.transaction.DefaultTransactionOptions] = None)\n\nClient for interacting with Cloud Spanner API.\n| **Note:** Since the Cloud Spanner API requires the gRPC transport, no `_http` argument is accepted by this class."]]