- 3.57.0 (latest)
- 3.56.0
- 3.55.0
- 3.54.0
- 3.53.0
- 3.52.0
- 3.51.0
- 3.50.1
- 3.46.0
- 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
Model a set of read-only queries to a database as a snapshot.
Classes
Snapshot
Snapshot
(
session
,
read_timestamp
=
None
,
min_read_timestamp
=
None
,
max_staleness
=
None
,
exact_staleness
=
None
,
multi_use
=
False
,
)
Allow a set of reads / SQL statements with shared staleness.
If no options are passed, reads will use the strong
model, reading
at a timestamp where all previously committed transactions are visible.
Parameters
Name
Description
session
read_timestamp
datetime.datetime
Execute all reads at the given timestamp.
min_read_timestamp
datetime.datetime
Execute all reads at a timestamp >= min_read_timestamp
.
max_staleness
datetime.timedelta
Read data at a timestamp >= NOW - max_staleness
seconds.
exact_staleness
datetime.timedelta
Execute all reads at a timestamp that is exact_staleness
old.
multi_use
bool
If true, multiple read
/ execute_sql
calls can be performed with the snapshot in the context of a read-only transaction, used to ensure isolation / consistency. Incompatible with max_staleness
and min_read_timestamp
.
