Cloud Spanner V1 Client - Class DirectedReadOptions (1.68.0)

Reference documentation and code samples for the Cloud Spanner V1 Client class DirectedReadOptions.

The DirectedReadOptions can be used to indicate which replicas or regions should be used for non-transactional reads or queries.

DirectedReadOptions may only be specified for a read-only transaction, otherwise the API will return an INVALID_ARGUMENT error.

Generated from protobuf message google.spanner.v1.DirectedReadOptions

Namespace

Google \ Cloud \ Spanner \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ include_replicas Google\Cloud\Spanner\V1\DirectedReadOptions\IncludeReplicas

Include_replicas indicates the order of replicas (as they appear in this list) to process the request. If auto_failover_disabled is set to true and all replicas are exhausted without finding a healthy replica, Spanner will wait for a replica in the list to become available, requests may fail due to DEADLINE_EXCEEDED errors.

↳ exclude_replicas Google\Cloud\Spanner\V1\DirectedReadOptions\ExcludeReplicas

Exclude_replicas indicates that should be excluded from serving requests. Spanner will not route requests to the replicas in this list.

getIncludeReplicas

Include_replicas indicates the order of replicas (as they appear in this list) to process the request. If auto_failover_disabled is set to true and all replicas are exhausted without finding a healthy replica, Spanner will wait for a replica in the list to become available, requests may fail due to DEADLINE_EXCEEDED errors.

Returns
TypeDescription
Google\Cloud\Spanner\V1\DirectedReadOptions\IncludeReplicas|null

hasIncludeReplicas

setIncludeReplicas

Include_replicas indicates the order of replicas (as they appear in this list) to process the request. If auto_failover_disabled is set to true and all replicas are exhausted without finding a healthy replica, Spanner will wait for a replica in the list to become available, requests may fail due to DEADLINE_EXCEEDED errors.

Parameter
NameDescription
var Google\Cloud\Spanner\V1\DirectedReadOptions\IncludeReplicas
Returns
TypeDescription
$this

getExcludeReplicas

Exclude_replicas indicates that should be excluded from serving requests. Spanner will not route requests to the replicas in this list.

Returns
TypeDescription
Google\Cloud\Spanner\V1\DirectedReadOptions\ExcludeReplicas|null

hasExcludeReplicas

setExcludeReplicas

Exclude_replicas indicates that should be excluded from serving requests. Spanner will not route requests to the replicas in this list.

Parameter
NameDescription
var Google\Cloud\Spanner\V1\DirectedReadOptions\ExcludeReplicas
Returns
TypeDescription
$this

getReplicas

Returns
TypeDescription
string