- 6.107.0 (latest)
- 6.103.0
- 6.102.1
- 6.101.1
- 6.100.0
- 6.99.0
- 6.98.1
- 6.97.1
- 6.96.1
- 6.95.1
- 6.94.0
- 6.93.0
- 6.89.0
- 6.88.0
- 6.87.0
- 6.86.0
- 6.85.0
- 6.83.0
- 6.82.0
- 6.80.1
- 6.79.0
- 6.77.0
- 6.74.1
- 6.72.0
- 6.71.0
- 6.69.0
- 6.68.0
- 6.66.0
- 6.65.1
- 6.62.0
- 6.60.0
- 6.58.0
- 6.57.0
- 6.56.0
- 6.55.0
- 6.54.0
- 6.53.0
- 6.52.1
- 6.51.0
- 6.50.1
- 6.49.0
- 6.25.1
- 6.24.0
- 6.23.4
- 6.22.0
- 6.21.2
- 6.20.0
- 6.19.1
- 6.18.0
- 6.17.4
- 6.14.1
public static final class RoutingHint.Builder extends GeneratedMessageV3.Builder<RoutingHint.Builder> implements RoutingHintOrBuilder RoutingHint can be optionally added to location-aware Spanner
requests. It gives the server hints that can be used to route the request to
an appropriate server, potentially significantly decreasing latency and
improving throughput. To achieve improved performance, most fields must be
filled in with accurate values.
The presence of a valid RoutingHint tells the server that the client
is location-aware.
RoutingHint does not change the semantics of the request; it is
purely a performance hint; the request will perform the same actions on the
database's data as if RoutingHint were not present. However, if
the RoutingHint is incomplete or incorrect, the response may include
a CacheUpdate the client can use to correct its location cache.
Protobuf type google.spanner.v1.RoutingHint
Inheritance
Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > RoutingHint.BuilderImplements
RoutingHintOrBuilderStatic Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
Methods
addAllSkippedTabletUid(Iterable<? extends RoutingHint.SkippedTablet> values)
public RoutingHint.Builder addAllSkippedTabletUid(Iterable<? extends RoutingHint.SkippedTablet> values) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<? extends com.google.spanner.v1.RoutingHint.SkippedTablet> |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public RoutingHint.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)| Parameters | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
value |
Object |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
addSkippedTabletUid(RoutingHint.SkippedTablet value)
public RoutingHint.Builder addSkippedTabletUid(RoutingHint.SkippedTablet value) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
value |
RoutingHint.SkippedTablet |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
addSkippedTabletUid(RoutingHint.SkippedTablet.Builder builderForValue)
public RoutingHint.Builder addSkippedTabletUid(RoutingHint.SkippedTablet.Builder builderForValue) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
RoutingHint.SkippedTablet.Builder |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
addSkippedTabletUid(int index, RoutingHint.SkippedTablet value)
public RoutingHint.Builder addSkippedTabletUid(int index, RoutingHint.SkippedTablet value) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
RoutingHint.SkippedTablet |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
addSkippedTabletUid(int index, RoutingHint.SkippedTablet.Builder builderForValue)
public RoutingHint.Builder addSkippedTabletUid(int index, RoutingHint.SkippedTablet.Builder builderForValue) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
RoutingHint.SkippedTablet.Builder |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
addSkippedTabletUidBuilder()
public RoutingHint.SkippedTablet.Builder addSkippedTabletUidBuilder() If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.SkippedTablet.Builder |
|
addSkippedTabletUidBuilder(int index)
public RoutingHint.SkippedTablet.Builder addSkippedTabletUidBuilder(int index) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.SkippedTablet.Builder |
|
build()
public RoutingHint build()| Returns | |
|---|---|
| Type | Description |
RoutingHint |
|
buildPartial()
public RoutingHint buildPartial()| Returns | |
|---|---|
| Type | Description |
RoutingHint |
|
clear()
public RoutingHint.Builder clear()| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
clearClientLocation()
public RoutingHint.Builder clearClientLocation()If present, the client's current location. This should be the name of a Google Cloud zone or region, such as "us-central1".
If absent, the client's location will be assumed to be the same as the location of the server the client ends up connected to.
Locations are primarily valuable for clients that connect from regions other than the ones that contain the Spanner database.
string client_location = 10;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearDatabaseId()
public RoutingHint.Builder clearDatabaseId() The database ID of the database being accessed, see
CacheUpdate.database_id. Should match the cache entries that were used
to generate the rest of the fields in this RoutingHint.
uint64 database_id = 2;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearField(Descriptors.FieldDescriptor field)
public RoutingHint.Builder clearField(Descriptors.FieldDescriptor field)| Parameter | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
clearGroupUid()
public RoutingHint.Builder clearGroupUid() The group UID of the group that the client believes serves the range
defined by key and limit_key. See Range.group_uid for more details.
uint64 group_uid = 6;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearKey()
public RoutingHint.Builder clearKey() The key / key range that this request accesses. For operations that
access a single key, key should be set and limit_key should be empty.
For operations that access a key range, key and limit_key should both
be set, to the inclusive start and exclusive end of the range respectively.
The keys are encoded in "sortable string format" (ssformat), using a
KeyRecipe that is appropriate for the request. See KeyRecipe for more
details.
bytes key = 4;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearLimitKey()
public RoutingHint.Builder clearLimitKey() If this request targets a key range, this is the exclusive end of the
range. See key for more details.
bytes limit_key = 5;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearOneof(Descriptors.OneofDescriptor oneof)
public RoutingHint.Builder clearOneof(Descriptors.OneofDescriptor oneof)| Parameter | |
|---|---|
| Name | Description |
oneof |
OneofDescriptor |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
clearOperationUid()
public RoutingHint.Builder clearOperationUid() A session-scoped unique ID for the operation, computed client-side.
Requests with the same operation_uid should have a shared 'shape',
meaning that some fields are expected to be the same, such as the SQL
query, the target table/columns (for reads) etc. Requests with the same
operation_uid are meant to differ only in fields like keys/key
ranges/query parameters, transaction IDs, etc.
operation_uid must be non-zero for RoutingHint to be valid.
uint64 operation_uid = 1;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearSchemaGeneration()
public RoutingHint.Builder clearSchemaGeneration() The schema generation of the recipe that was used to generate key and
limit_key. See also RecipeList.schema_generation.
bytes schema_generation = 3;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearSkippedTabletUid()
public RoutingHint.Builder clearSkippedTabletUid() If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
clearSplitId()
public RoutingHint.Builder clearSplitId() The split ID of the split that the client believes contains the range
defined by key and limit_key. See Range.split_id for more details.
uint64 split_id = 7;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clearTabletUid()
public RoutingHint.Builder clearTabletUid() The tablet UID of the tablet from group group_uid that the client
believes is best to serve this request. See Group.local_tablet_uids and
Group.leader_tablet_uid.
uint64 tablet_uid = 8;
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
clone()
public RoutingHint.Builder clone()| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
getClientLocation()
public String getClientLocation()If present, the client's current location. This should be the name of a Google Cloud zone or region, such as "us-central1".
If absent, the client's location will be assumed to be the same as the location of the server the client ends up connected to.
Locations are primarily valuable for clients that connect from regions other than the ones that contain the Spanner database.
string client_location = 10;
| Returns | |
|---|---|
| Type | Description |
String |
The clientLocation. |
getClientLocationBytes()
public ByteString getClientLocationBytes()If present, the client's current location. This should be the name of a Google Cloud zone or region, such as "us-central1".
If absent, the client's location will be assumed to be the same as the location of the server the client ends up connected to.
Locations are primarily valuable for clients that connect from regions other than the ones that contain the Spanner database.
string client_location = 10;
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for clientLocation. |
getDatabaseId()
public long getDatabaseId() The database ID of the database being accessed, see
CacheUpdate.database_id. Should match the cache entries that were used
to generate the rest of the fields in this RoutingHint.
uint64 database_id = 2;
| Returns | |
|---|---|
| Type | Description |
long |
The databaseId. |
getDefaultInstanceForType()
public RoutingHint getDefaultInstanceForType()| Returns | |
|---|---|
| Type | Description |
RoutingHint |
|
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
getGroupUid()
public long getGroupUid() The group UID of the group that the client believes serves the range
defined by key and limit_key. See Range.group_uid for more details.
uint64 group_uid = 6;
| Returns | |
|---|---|
| Type | Description |
long |
The groupUid. |
getKey()
public ByteString getKey() The key / key range that this request accesses. For operations that
access a single key, key should be set and limit_key should be empty.
For operations that access a key range, key and limit_key should both
be set, to the inclusive start and exclusive end of the range respectively.
The keys are encoded in "sortable string format" (ssformat), using a
KeyRecipe that is appropriate for the request. See KeyRecipe for more
details.
bytes key = 4;
| Returns | |
|---|---|
| Type | Description |
ByteString |
The key. |
getLimitKey()
public ByteString getLimitKey() If this request targets a key range, this is the exclusive end of the
range. See key for more details.
bytes limit_key = 5;
| Returns | |
|---|---|
| Type | Description |
ByteString |
The limitKey. |
getOperationUid()
public long getOperationUid() A session-scoped unique ID for the operation, computed client-side.
Requests with the same operation_uid should have a shared 'shape',
meaning that some fields are expected to be the same, such as the SQL
query, the target table/columns (for reads) etc. Requests with the same
operation_uid are meant to differ only in fields like keys/key
ranges/query parameters, transaction IDs, etc.
operation_uid must be non-zero for RoutingHint to be valid.
uint64 operation_uid = 1;
| Returns | |
|---|---|
| Type | Description |
long |
The operationUid. |
getSchemaGeneration()
public ByteString getSchemaGeneration() The schema generation of the recipe that was used to generate key and
limit_key. See also RecipeList.schema_generation.
bytes schema_generation = 3;
| Returns | |
|---|---|
| Type | Description |
ByteString |
The schemaGeneration. |
getSkippedTabletUid(int index)
public RoutingHint.SkippedTablet getSkippedTabletUid(int index) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.SkippedTablet |
|
getSkippedTabletUidBuilder(int index)
public RoutingHint.SkippedTablet.Builder getSkippedTabletUidBuilder(int index) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.SkippedTablet.Builder |
|
getSkippedTabletUidBuilderList()
public List<RoutingHint.SkippedTablet.Builder> getSkippedTabletUidBuilderList() If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Returns | |
|---|---|
| Type | Description |
List<Builder> |
|
getSkippedTabletUidCount()
public int getSkippedTabletUidCount() If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Returns | |
|---|---|
| Type | Description |
int |
|
getSkippedTabletUidList()
public List<RoutingHint.SkippedTablet> getSkippedTabletUidList() If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Returns | |
|---|---|
| Type | Description |
List<SkippedTablet> |
|
getSkippedTabletUidOrBuilder(int index)
public RoutingHint.SkippedTabletOrBuilder getSkippedTabletUidOrBuilder(int index) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.SkippedTabletOrBuilder |
|
getSkippedTabletUidOrBuilderList()
public List<? extends RoutingHint.SkippedTabletOrBuilder> getSkippedTabletUidOrBuilderList() If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Returns | |
|---|---|
| Type | Description |
List<? extends com.google.spanner.v1.RoutingHint.SkippedTabletOrBuilder> |
|
getSplitId()
public long getSplitId() The split ID of the split that the client believes contains the range
defined by key and limit_key. See Range.split_id for more details.
uint64 split_id = 7;
| Returns | |
|---|---|
| Type | Description |
long |
The splitId. |
getTabletUid()
public long getTabletUid() The tablet UID of the tablet from group group_uid that the client
believes is best to serve this request. See Group.local_tablet_uids and
Group.leader_tablet_uid.
uint64 tablet_uid = 8;
| Returns | |
|---|---|
| Type | Description |
long |
The tabletUid. |
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()| Returns | |
|---|---|
| Type | Description |
FieldAccessorTable |
|
isInitialized()
public final boolean isInitialized()| Returns | |
|---|---|
| Type | Description |
boolean |
|
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public RoutingHint.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)| Parameters | |
|---|---|
| Name | Description |
input |
CodedInputStream |
extensionRegistry |
ExtensionRegistryLite |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
mergeFrom(Message other)
public RoutingHint.Builder mergeFrom(Message other)| Parameter | |
|---|---|
| Name | Description |
other |
Message |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
mergeFrom(RoutingHint other)
public RoutingHint.Builder mergeFrom(RoutingHint other)| Parameter | |
|---|---|
| Name | Description |
other |
RoutingHint |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
mergeUnknownFields(UnknownFieldSet unknownFields)
public final RoutingHint.Builder mergeUnknownFields(UnknownFieldSet unknownFields)| Parameter | |
|---|---|
| Name | Description |
unknownFields |
UnknownFieldSet |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
removeSkippedTabletUid(int index)
public RoutingHint.Builder removeSkippedTabletUid(int index) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
setClientLocation(String value)
public RoutingHint.Builder setClientLocation(String value)If present, the client's current location. This should be the name of a Google Cloud zone or region, such as "us-central1".
If absent, the client's location will be assumed to be the same as the location of the server the client ends up connected to.
Locations are primarily valuable for clients that connect from regions other than the ones that contain the Spanner database.
string client_location = 10;
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe clientLocation to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setClientLocationBytes(ByteString value)
public RoutingHint.Builder setClientLocationBytes(ByteString value)If present, the client's current location. This should be the name of a Google Cloud zone or region, such as "us-central1".
If absent, the client's location will be assumed to be the same as the location of the server the client ends up connected to.
Locations are primarily valuable for clients that connect from regions other than the ones that contain the Spanner database.
string client_location = 10;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for clientLocation to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setDatabaseId(long value)
public RoutingHint.Builder setDatabaseId(long value) The database ID of the database being accessed, see
CacheUpdate.database_id. Should match the cache entries that were used
to generate the rest of the fields in this RoutingHint.
uint64 database_id = 2;
| Parameter | |
|---|---|
| Name | Description |
value |
longThe databaseId to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setField(Descriptors.FieldDescriptor field, Object value)
public RoutingHint.Builder setField(Descriptors.FieldDescriptor field, Object value)| Parameters | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
value |
Object |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
setGroupUid(long value)
public RoutingHint.Builder setGroupUid(long value) The group UID of the group that the client believes serves the range
defined by key and limit_key. See Range.group_uid for more details.
uint64 group_uid = 6;
| Parameter | |
|---|---|
| Name | Description |
value |
longThe groupUid to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setKey(ByteString value)
public RoutingHint.Builder setKey(ByteString value) The key / key range that this request accesses. For operations that
access a single key, key should be set and limit_key should be empty.
For operations that access a key range, key and limit_key should both
be set, to the inclusive start and exclusive end of the range respectively.
The keys are encoded in "sortable string format" (ssformat), using a
KeyRecipe that is appropriate for the request. See KeyRecipe for more
details.
bytes key = 4;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe key to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setLimitKey(ByteString value)
public RoutingHint.Builder setLimitKey(ByteString value) If this request targets a key range, this is the exclusive end of the
range. See key for more details.
bytes limit_key = 5;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe limitKey to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setOperationUid(long value)
public RoutingHint.Builder setOperationUid(long value) A session-scoped unique ID for the operation, computed client-side.
Requests with the same operation_uid should have a shared 'shape',
meaning that some fields are expected to be the same, such as the SQL
query, the target table/columns (for reads) etc. Requests with the same
operation_uid are meant to differ only in fields like keys/key
ranges/query parameters, transaction IDs, etc.
operation_uid must be non-zero for RoutingHint to be valid.
uint64 operation_uid = 1;
| Parameter | |
|---|---|
| Name | Description |
value |
longThe operationUid to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public RoutingHint.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)| Parameters | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
index |
int |
value |
Object |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
setSchemaGeneration(ByteString value)
public RoutingHint.Builder setSchemaGeneration(ByteString value) The schema generation of the recipe that was used to generate key and
limit_key. See also RecipeList.schema_generation.
bytes schema_generation = 3;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe schemaGeneration to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setSkippedTabletUid(int index, RoutingHint.SkippedTablet value)
public RoutingHint.Builder setSkippedTabletUid(int index, RoutingHint.SkippedTablet value) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
RoutingHint.SkippedTablet |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
setSkippedTabletUid(int index, RoutingHint.SkippedTablet.Builder builderForValue)
public RoutingHint.Builder setSkippedTabletUid(int index, RoutingHint.SkippedTablet.Builder builderForValue) If the client had multiple options for tablet selection, and some of its
first choices were unhealthy (e.g., the server is unreachable, or
Tablet.skip is true), this field will contain the tablet UIDs of those
tablets, with their incarnations. The server may include a CacheUpdate
with new locations for those tablets.
repeated .google.spanner.v1.RoutingHint.SkippedTablet skipped_tablet_uid = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
RoutingHint.SkippedTablet.Builder |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|
setSplitId(long value)
public RoutingHint.Builder setSplitId(long value) The split ID of the split that the client believes contains the range
defined by key and limit_key. See Range.split_id for more details.
uint64 split_id = 7;
| Parameter | |
|---|---|
| Name | Description |
value |
longThe splitId to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setTabletUid(long value)
public RoutingHint.Builder setTabletUid(long value) The tablet UID of the tablet from group group_uid that the client
believes is best to serve this request. See Group.local_tablet_uids and
Group.leader_tablet_uid.
uint64 tablet_uid = 8;
| Parameter | |
|---|---|
| Name | Description |
value |
longThe tabletUid to set. |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
This builder for chaining. |
setUnknownFields(UnknownFieldSet unknownFields)
public final RoutingHint.Builder setUnknownFields(UnknownFieldSet unknownFields)| Parameter | |
|---|---|
| Name | Description |
unknownFields |
UnknownFieldSet |
| Returns | |
|---|---|
| Type | Description |
RoutingHint.Builder |
|