Option for google::cloud::Options to indicate which replicas or regions should be used for reads/queries in read-only or single-use transactions.
Use of DirectedReadOptions within a read-write transaction will result in a kInvalidArgument error.
The IncludeReplicas variant lists the replicas to try (in order) to process the request, and what to do if the list is exhausted without finding a healthy replica.
Alternately, the ExcludeReplicas variant lists replicas that should be excluded from serving the request.
Type Aliases
Type
Alias Of: absl::variant< absl::monostate, IncludeReplicas, ExcludeReplicas >
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-26 UTC."],[[["This webpage provides documentation for the `DirectedReadOption` in the Google Cloud Spanner C++ library, spanning versions from 2.11.0 up to the latest release candidate, 2.37.0-rc."],["`DirectedReadOption` allows specifying which replicas or regions should be used for reads or queries in read-only or single-use transactions, enhancing control over data access."],["Using `DirectedReadOption` within read-write transactions will lead to a `kInvalidArgument` error, thus it is restricted to only read-only and single-use transactions."],["The option supports `IncludeReplicas` to specify a prioritized list of replicas for processing requests, or `ExcludeReplicas` to specify replicas to avoid."],["The type alias for this feature is an `absl::variant` which may contain the states of `absl::monostate`, `IncludeReplicas`, or `ExcludeReplicas`."]]],[]]
