public static final class ReadRequest.Builder extends GeneratedMessageV3.Builder<ReadRequest.Builder> implements ReadRequestOrBuilderThe request for Read and StreamingRead.
Protobuf type google.spanner.v1.ReadRequest
Inheritance
Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > ReadRequest.BuilderImplements
ReadRequestOrBuilderMethods
addAllColumns(Iterable<String> values)
public ReadRequest.Builder addAllColumns(Iterable<String> values)Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| values | Iterable<String>The columns to add. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
addColumns(String value)
public ReadRequest.Builder addColumns(String value)Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| value | StringThe columns to add. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
addColumnsBytes(ByteString value)
public ReadRequest.Builder addColumnsBytes(ByteString value)Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| value | ByteStringThe bytes of the columns to add. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public ReadRequest.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)| Name | Description |
| field | FieldDescriptor |
| value | Object |
| Type | Description |
| ReadRequest.Builder |
build()
public ReadRequest build()| Type | Description |
| ReadRequest |
buildPartial()
public ReadRequest buildPartial()| Type | Description |
| ReadRequest |
clear()
public ReadRequest.Builder clear()| Type | Description |
| ReadRequest.Builder |
clearColumns()
public ReadRequest.Builder clearColumns()Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
clearField(Descriptors.FieldDescriptor field)
public ReadRequest.Builder clearField(Descriptors.FieldDescriptor field)| Name | Description |
| field | FieldDescriptor |
| Type | Description |
| ReadRequest.Builder |
clearIndex()
public ReadRequest.Builder clearIndex()If non-empty, the name of an index on table. This index is used instead of the table primary key when interpreting key_set and sorting result rows. See key_set for further information.
string index = 4;
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
clearKeySet()
public ReadRequest.Builder clearKeySet() Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| ReadRequest.Builder |
clearLimit()
public ReadRequest.Builder clearLimit() If greater than zero, only the first limit rows are yielded. If limit
is zero, the default is no limit. A limit cannot be specified if
partition_token is set.
int64 limit = 8;
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
clearOneof(Descriptors.OneofDescriptor oneof)
public ReadRequest.Builder clearOneof(Descriptors.OneofDescriptor oneof)| Name | Description |
| oneof | OneofDescriptor |
| Type | Description |
| ReadRequest.Builder |
clearPartitionToken()
public ReadRequest.Builder clearPartitionToken()If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create this partition_token.
bytes partition_token = 10;
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
clearRequestOptions()
public ReadRequest.Builder clearRequestOptions()Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Type | Description |
| ReadRequest.Builder |
clearResumeToken()
public ReadRequest.Builder clearResumeToken() If this request is resuming a previously interrupted read,
resume_token should be copied from the last
PartialResultSet yielded before the interruption. Doing this
enables the new read to resume where the last read left off. The
rest of the request parameters must exactly match the request
that yielded this token.
bytes resume_token = 9;
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
clearSession()
public ReadRequest.Builder clearSession()Required. The session in which the read should be performed.
string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
clearTable()
public ReadRequest.Builder clearTable()Required. The name of the table in the database to be read.
string table = 3 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
clearTransaction()
public ReadRequest.Builder clearTransaction()The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Type | Description |
| ReadRequest.Builder |
clone()
public ReadRequest.Builder clone()| Type | Description |
| ReadRequest.Builder |
getColumns(int index)
public String getColumns(int index)Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| index | intThe index of the element to return. |
| Type | Description |
| String | The columns at the given index. |
getColumnsBytes(int index)
public ByteString getColumnsBytes(int index)Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| index | intThe index of the value to return. |
| Type | Description |
| ByteString | The bytes of the columns at the given index. |
getColumnsCount()
public int getColumnsCount()Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| int | The count of columns. |
getColumnsList()
public ProtocolStringList getColumnsList()Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| ProtocolStringList | A list containing the columns. |
getDefaultInstanceForType()
public ReadRequest getDefaultInstanceForType()| Type | Description |
| ReadRequest |
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()| Type | Description |
| Descriptor |
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()| Type | Description |
| Descriptor |
getIndex()
public String getIndex()If non-empty, the name of an index on table. This index is used instead of the table primary key when interpreting key_set and sorting result rows. See key_set for further information.
string index = 4;
| Type | Description |
| String | The index. |
getIndexBytes()
public ByteString getIndexBytes()If non-empty, the name of an index on table. This index is used instead of the table primary key when interpreting key_set and sorting result rows. See key_set for further information.
string index = 4;
| Type | Description |
| ByteString | The bytes for index. |
getKeySet()
public KeySet getKeySet() Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| KeySet | The keySet. |
getKeySetBuilder()
public KeySet.Builder getKeySetBuilder() Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| KeySet.Builder |
getKeySetOrBuilder()
public KeySetOrBuilder getKeySetOrBuilder() Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| KeySetOrBuilder |
getLimit()
public long getLimit() If greater than zero, only the first limit rows are yielded. If limit
is zero, the default is no limit. A limit cannot be specified if
partition_token is set.
int64 limit = 8;
| Type | Description |
| long | The limit. |
getPartitionToken()
public ByteString getPartitionToken()If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create this partition_token.
bytes partition_token = 10;
| Type | Description |
| ByteString | The partitionToken. |
getRequestOptions()
public RequestOptions getRequestOptions()Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Type | Description |
| RequestOptions | The requestOptions. |
getRequestOptionsBuilder()
public RequestOptions.Builder getRequestOptionsBuilder()Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Type | Description |
| RequestOptions.Builder |
getRequestOptionsOrBuilder()
public RequestOptionsOrBuilder getRequestOptionsOrBuilder()Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Type | Description |
| RequestOptionsOrBuilder |
getResumeToken()
public ByteString getResumeToken() If this request is resuming a previously interrupted read,
resume_token should be copied from the last
PartialResultSet yielded before the interruption. Doing this
enables the new read to resume where the last read left off. The
rest of the request parameters must exactly match the request
that yielded this token.
bytes resume_token = 9;
| Type | Description |
| ByteString | The resumeToken. |
getSession()
public String getSession()Required. The session in which the read should be performed.
string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
| Type | Description |
| String | The session. |
getSessionBytes()
public ByteString getSessionBytes()Required. The session in which the read should be performed.
string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
| Type | Description |
| ByteString | The bytes for session. |
getTable()
public String getTable()Required. The name of the table in the database to be read.
string table = 3 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| String | The table. |
getTableBytes()
public ByteString getTableBytes()Required. The name of the table in the database to be read.
string table = 3 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| ByteString | The bytes for table. |
getTransaction()
public TransactionSelector getTransaction()The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Type | Description |
| TransactionSelector | The transaction. |
getTransactionBuilder()
public TransactionSelector.Builder getTransactionBuilder()The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Type | Description |
| TransactionSelector.Builder |
getTransactionOrBuilder()
public TransactionSelectorOrBuilder getTransactionOrBuilder()The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Type | Description |
| TransactionSelectorOrBuilder |
hasKeySet()
public boolean hasKeySet() Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| boolean | Whether the keySet field is set. |
hasRequestOptions()
public boolean hasRequestOptions()Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Type | Description |
| boolean | Whether the requestOptions field is set. |
hasTransaction()
public boolean hasTransaction()The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Type | Description |
| boolean | Whether the transaction field is set. |
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()| Type | Description |
| FieldAccessorTable |
isInitialized()
public final boolean isInitialized()| Type | Description |
| boolean |
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public ReadRequest.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)| Name | Description |
| input | CodedInputStream |
| extensionRegistry | ExtensionRegistryLite |
| Type | Description |
| ReadRequest.Builder |
| Type | Description |
| IOException |
mergeFrom(Message other)
public ReadRequest.Builder mergeFrom(Message other)| Name | Description |
| other | Message |
| Type | Description |
| ReadRequest.Builder |
mergeFrom(ReadRequest other)
public ReadRequest.Builder mergeFrom(ReadRequest other)| Name | Description |
| other | ReadRequest |
| Type | Description |
| ReadRequest.Builder |
mergeKeySet(KeySet value)
public ReadRequest.Builder mergeKeySet(KeySet value) Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| value | KeySet |
| Type | Description |
| ReadRequest.Builder |
mergeRequestOptions(RequestOptions value)
public ReadRequest.Builder mergeRequestOptions(RequestOptions value)Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Name | Description |
| value | RequestOptions |
| Type | Description |
| ReadRequest.Builder |
mergeTransaction(TransactionSelector value)
public ReadRequest.Builder mergeTransaction(TransactionSelector value)The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Name | Description |
| value | TransactionSelector |
| Type | Description |
| ReadRequest.Builder |
mergeUnknownFields(UnknownFieldSet unknownFields)
public final ReadRequest.Builder mergeUnknownFields(UnknownFieldSet unknownFields)| Name | Description |
| unknownFields | UnknownFieldSet |
| Type | Description |
| ReadRequest.Builder |
setColumns(int index, String value)
public ReadRequest.Builder setColumns(int index, String value)Required. The columns of table to be returned for each row matching this request.
repeated string columns = 5 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| index | intThe index to set the value at. |
| value | StringThe columns to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setField(Descriptors.FieldDescriptor field, Object value)
public ReadRequest.Builder setField(Descriptors.FieldDescriptor field, Object value)| Name | Description |
| field | FieldDescriptor |
| value | Object |
| Type | Description |
| ReadRequest.Builder |
setIndex(String value)
public ReadRequest.Builder setIndex(String value)If non-empty, the name of an index on table. This index is used instead of the table primary key when interpreting key_set and sorting result rows. See key_set for further information.
string index = 4;
| Name | Description |
| value | StringThe index to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setIndexBytes(ByteString value)
public ReadRequest.Builder setIndexBytes(ByteString value)If non-empty, the name of an index on table. This index is used instead of the table primary key when interpreting key_set and sorting result rows. See key_set for further information.
string index = 4;
| Name | Description |
| value | ByteStringThe bytes for index to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setKeySet(KeySet value)
public ReadRequest.Builder setKeySet(KeySet value) Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| value | KeySet |
| Type | Description |
| ReadRequest.Builder |
setKeySet(KeySet.Builder builderForValue)
public ReadRequest.Builder setKeySet(KeySet.Builder builderForValue) Required. key_set identifies the rows to be yielded. key_set names the
primary keys of the rows in table to be yielded, unless index
is present. If index is present, then key_set instead names
index keys in index.
If the partition_token field is empty, rows are yielded
in table primary key order (if index is empty) or index key order
(if index is non-empty). If the partition_token field is not
empty, rows will be yielded in an unspecified order.
It is not an error for the key_set to name rows that do not
exist in the database. Read yields nothing for nonexistent rows.
.google.spanner.v1.KeySet key_set = 6 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| builderForValue | KeySet.Builder |
| Type | Description |
| ReadRequest.Builder |
setLimit(long value)
public ReadRequest.Builder setLimit(long value) If greater than zero, only the first limit rows are yielded. If limit
is zero, the default is no limit. A limit cannot be specified if
partition_token is set.
int64 limit = 8;
| Name | Description |
| value | longThe limit to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setPartitionToken(ByteString value)
public ReadRequest.Builder setPartitionToken(ByteString value)If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create this partition_token.
bytes partition_token = 10;
| Name | Description |
| value | ByteStringThe partitionToken to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public ReadRequest.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)| Name | Description |
| field | FieldDescriptor |
| index | int |
| value | Object |
| Type | Description |
| ReadRequest.Builder |
setRequestOptions(RequestOptions value)
public ReadRequest.Builder setRequestOptions(RequestOptions value)Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Name | Description |
| value | RequestOptions |
| Type | Description |
| ReadRequest.Builder |
setRequestOptions(RequestOptions.Builder builderForValue)
public ReadRequest.Builder setRequestOptions(RequestOptions.Builder builderForValue)Common options for this request.
.google.spanner.v1.RequestOptions request_options = 11;
| Name | Description |
| builderForValue | RequestOptions.Builder |
| Type | Description |
| ReadRequest.Builder |
setResumeToken(ByteString value)
public ReadRequest.Builder setResumeToken(ByteString value) If this request is resuming a previously interrupted read,
resume_token should be copied from the last
PartialResultSet yielded before the interruption. Doing this
enables the new read to resume where the last read left off. The
rest of the request parameters must exactly match the request
that yielded this token.
bytes resume_token = 9;
| Name | Description |
| value | ByteStringThe resumeToken to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setSession(String value)
public ReadRequest.Builder setSession(String value)Required. The session in which the read should be performed.
string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
| Name | Description |
| value | StringThe session to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setSessionBytes(ByteString value)
public ReadRequest.Builder setSessionBytes(ByteString value)Required. The session in which the read should be performed.
string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
| Name | Description |
| value | ByteStringThe bytes for session to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setTable(String value)
public ReadRequest.Builder setTable(String value)Required. The name of the table in the database to be read.
string table = 3 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| value | StringThe table to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setTableBytes(ByteString value)
public ReadRequest.Builder setTableBytes(ByteString value)Required. The name of the table in the database to be read.
string table = 3 [(.google.api.field_behavior) = REQUIRED];
| Name | Description |
| value | ByteStringThe bytes for table to set. |
| Type | Description |
| ReadRequest.Builder | This builder for chaining. |
setTransaction(TransactionSelector value)
public ReadRequest.Builder setTransaction(TransactionSelector value)The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Name | Description |
| value | TransactionSelector |
| Type | Description |
| ReadRequest.Builder |
setTransaction(TransactionSelector.Builder builderForValue)
public ReadRequest.Builder setTransaction(TransactionSelector.Builder builderForValue)The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
.google.spanner.v1.TransactionSelector transaction = 2;
| Name | Description |
| builderForValue | TransactionSelector.Builder |
| Type | Description |
| ReadRequest.Builder |
setUnknownFields(UnknownFieldSet unknownFields)
public final ReadRequest.Builder setUnknownFields(UnknownFieldSet unknownFields)| Name | Description |
| unknownFields | UnknownFieldSet |
| Type | Description |
| ReadRequest.Builder |