User friendly container for Cloud Spanner Database.
Classes
BatchCheckout
BatchCheckout(database, request_options=None)
Context manager for using a batch from a database.
Inside the context manager, checks out a session from the database, creates a batch from it, making the batch available.
Caller must not use the batch to perform API requests outside the scope of the context manager.
Parameters | |
---|---|
Name | Description |
database |
Database
database to use |
request_options |
RequestOptions
(Optional) Common options for the commit request. If a dict is provided, it must be of the same form as the protobuf message RequestOptions. |
BatchSnapshot
BatchSnapshot(database, read_timestamp=None, exact_staleness=None)
Wrapper for generating and processing read / query batches.
Parameters | |
---|---|
Name | Description |
database |
Database
database to use |
read_timestamp |
Execute all reads at the given timestamp. |
exact_staleness |
Execute all reads at a timestamp that is |
Database
Database(
database_id,
instance,
ddl_statements=(),
pool=None,
logger=None,
encryption_config=None,
database_dialect=DatabaseDialect.DATABASE_DIALECT_UNSPECIFIED,
database_role=None,
enable_drop_protection=False,
)
Representation of a Cloud Spanner Database.
We can use a Database
to:
create
the databasereload
the databaseupdate
the databasedrop
the database
Parameters | |
---|---|
Name | Description |
database_id |
str
The ID of the database. |
instance |
Instance
The instance that owns the database. |
ddl_statements |
list of string
(Optional) DDL statements, excluding the CREATE DATABASE statement. |
pool |
concrete subclass of AbstractSessionPool.
(Optional) session pool to be used by database. If not passed, the database will construct an instance of BurstyPool. |
logger |
(Optional) a custom logger that is used if |
encryption_config |
EncryptionConfig or RestoreDatabaseEncryptionConfig or
(Optional) Encryption configuration for the database. If a dict is provided, it must be of the same form as either of the protobuf messages EncryptionConfig or RestoreDatabaseEncryptionConfig |
database_dialect |
DatabaseDialect
(Optional) database dialect for the database |
database_role |
str or None
(Optional) user-assigned database_role for the session. |
enable_drop_protection |
boolean
(Optional) Represents whether the database has drop protection enabled or not. |
SnapshotCheckout
SnapshotCheckout(database, **kw)
Context manager for using a snapshot from a database.
Inside the context manager, checks out a session from the database, creates a snapshot from it, making the snapshot available.
Caller must not use the snapshot to perform API requests outside the scope of the context manager.
Parameters | |
---|---|
Name | Description |
kw |
dict
Passed through to Snapshot constructor. |
database |
Database
database to use |