- 3.58.0 (latest)
- 3.57.0
- 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
RequestOptions(mapping=None, *, ignore_unknown_fields=False, **kwargs)
Common request options for various APIs.
Attributes |
|
---|---|
Name | Description |
priority |
google.cloud.spanner_v1.types.RequestOptions.Priority
Priority for the request. |
request_tag |
str
A per-request tag which can be applied to queries or reads, used for statistics collection. Both request_tag and
transaction_tag can be specified for a read or query
that belongs to a transaction. This field is ignored for
requests where it's not applicable (for example,
CommitRequest ). Legal characters for request_tag
values are all printable characters (ASCII 32 - 126) and the
length of a request_tag is limited to 50 characters. Values
that exceed this limit are truncated. Any leading underscore
(\_) characters are removed from the string.
|
transaction_tag |
str
A tag used for statistics collection about this transaction. Both request_tag and transaction_tag can be
specified for a read or query that belongs to a transaction.
The value of transaction_tag should be the same for all
requests belonging to the same transaction. If this request
doesn't belong to any transaction, transaction_tag is
ignored. Legal characters for transaction_tag values are
all printable characters (ASCII 32 - 126) and the length of
a transaction_tag is limited to 50 characters. Values
that exceed this limit are truncated. Any leading underscore
(\_) characters are removed from the string.
|
Classes
Priority
Priority(value)
The relative priority for requests. Note that priority isn't
applicable for
BeginTransaction][google.spanner.v1.Spanner.BeginTransaction]
.
The priority acts as a hint to the Cloud Spanner scheduler and doesn't guarantee priority or order of execution. For example:
- Some parts of a write operation always execute at
PRIORITY_HIGH
, regardless of the specified priority. This can cause you to see an increase in high priority workload even when executing a low priority request. This can also potentially cause a priority inversion where a lower priority request is fulfilled ahead of a higher priority request. - If a transaction contains multiple operations with different priorities, Cloud Spanner doesn't guarantee to process the higher priority operations first. There might be other constraints to satisfy, such as the order of operations.