GoogleApi.Spanner.V1.Model.ReadRequest (google_api_spanner v0.48.0)
View SourceThe request for Read and StreamingRead.
Attributes
-
columns
(type:list(String.t)
, default:nil
) - Required. The columns of table to be returned for each row matching this request. -
dataBoostEnabled
(type:boolean()
, default:nil
) - If this is for a partitioned read and this field is set totrue
, the request is executed with Spanner Data Boost independent compute resources. If the field is set totrue
but the request doesn't setpartition_token
, the API returns anINVALID_ARGUMENT
error. -
directedReadOptions
(type:GoogleApi.Spanner.V1.Model.DirectedReadOptions.t
, default:nil
) - Directed read options for this request. -
index
(type:String.t
, default:nil
) - 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. -
keySet
(type:GoogleApi.Spanner.V1.Model.KeySet.t
, default:nil
) - 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 isn't empty, rows are yielded in an unspecified order. It isn't an error for thekey_set
to name rows that don't exist in the database. Read yields nothing for nonexistent rows. -
limit
(type:String.t
, default:nil
) - If greater than zero, only the firstlimit
rows are yielded. Iflimit
is zero, the default is no limit. A limit can't be specified ifpartition_token
is set. -
lockHint
(type:String.t
, default:nil
) - Optional. Lock Hint for the request, it can only be used with read-write transactions. -
orderBy
(type:String.t
, default:nil
) - Optional. Order for the returned rows. By default, Spanner returns result rows in primary key order except for PartitionRead requests. For applications that don't require rows to be returned in primary key (ORDER_BY_PRIMARY_KEY
) order, settingORDER_BY_NO_ORDER
option allows Spanner to optimize row retrieval, resulting in lower latencies in certain cases (for example, bulk point lookups). -
partitionToken
(type:String.t
, default:nil
) - If present, results are restricted to the specified partition previously created usingPartitionRead
. 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. -
requestOptions
(type:GoogleApi.Spanner.V1.Model.RequestOptions.t
, default:nil
) - Common options for this request. -
resumeToken
(type:String.t
, default:nil
) - 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. -
table
(type:String.t
, default:nil
) - Required. The name of the table in the database to be read. -
transaction
(type:GoogleApi.Spanner.V1.Model.TransactionSelector.t
, default:nil
) - The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
Summary
Functions
Unwrap a decoded JSON object into its complex fields.
Types
@type t() :: %GoogleApi.Spanner.V1.Model.ReadRequest{ columns: [String.t()] | nil, dataBoostEnabled: boolean() | nil, directedReadOptions: GoogleApi.Spanner.V1.Model.DirectedReadOptions.t() | nil, index: String.t() | nil, keySet: GoogleApi.Spanner.V1.Model.KeySet.t() | nil, limit: String.t() | nil, lockHint: String.t() | nil, orderBy: String.t() | nil, partitionToken: String.t() | nil, requestOptions: GoogleApi.Spanner.V1.Model.RequestOptions.t() | nil, resumeToken: String.t() | nil, table: String.t() | nil, transaction: GoogleApi.Spanner.V1.Model.TransactionSelector.t() | nil }