- 3.46.0 (latest)
- 3.45.0
- 3.44.0
- 3.43.0
- 3.42.0
- 3.41.0
- 3.40.1
- 3.39.0
- 3.38.0
- 3.37.0
- 3.36.0
- 3.35.1
- 3.34.0
- 3.33.0
- 3.32.0
- 3.31.0
- 3.30.0
- 3.29.0
- 3.28.0
- 3.27.1
- 3.26.0
- 3.25.0
- 3.24.0
- 3.23.0
- 3.22.2
- 3.21.0
- 3.20.0
- 3.19.0
- 3.18.0
- 3.17.0
- 3.16.0
- 3.15.1
- 3.14.1
- 3.13.0
- 3.12.1
- 3.11.1
- 3.10.0
- 3.9.0
- 3.8.0
- 3.7.0
- 3.6.0
- 3.5.0
- 3.4.0
- 3.3.0
- 3.2.0
- 3.1.0
- 3.0.0
- 2.1.1
- 2.0.0
- 1.19.3
- 1.18.0
- 1.17.1
- 1.16.0
- 1.15.1
- 1.14.0
- 1.13.0
- 1.12.0
- 1.11.0
- 1.10.0
Spanner Client
Instantiating a Client
To use the API, the Client
class defines a high-level interface which handles authorization
and creating other objects:
from google.cloud import spanner
client = spanner.Client()
Long-lived Defaults
When creating a Client
, the
user_agent
and timeout_seconds
arguments have sensible
defaults
(DEFAULT_USER_AGENT
and
DEFAULT_TIMEOUT_SECONDS
).
However, you may over-ride them and these will be used throughout all API
requests made with the client
you create.
Configuration
For an overview of authentication in
google.cloud-python
, see Authentication.In addition to any authentication configuration, you can also set the
GCLOUD_PROJECT
environment variable for the Google Cloud Console project you’d like to interact with. If your code is running in Google App Engine or Google Compute Engine the project will be detected automatically. (Setting this environment variable is not required, you may instead pass theproject
explicitly when constructing aClient
).After configuring your environment, create a
Client
>>> from google.cloud import spanner
>>> client = spanner.Client()
or pass in credentials
and project
explicitly
>>> from google.cloud import spanner
>>> client = spanner.Client(project='my-project', credentials=creds)
Warnings about Multiprocessing
WARNING: When using multiprocessing, the application may hang if a
Client
instance is created
before multiprocessing.Pool
or multiprocessing.Process
invokes os.fork()
. The issue is under investigation, but may be only
happening on Macintosh and not Linux. See GRPC/GRPC#12455 for
more information.
Next Step
After a Client
, the next
highest-level object is an Instance
.
You’ll need one before you can interact with databases.
Next, learn about the Instance Admin.