You can call this operation to simultaneously read multiple rows of data from one or more tables.
The BatchGetRow operation is a set of multiple GetRow operations. The execution, returning of results, and capacity unit (CU) consumption of each operation are carried out independently.
Compared with the execution of a large number of GetRow operations, the use of the BatchGetRow operation can effectively reduce the request response time and increase the data read rate.
Request structure
message BatchGetRowRequest {
repeated TableInBatchGetRowRequest tables = 1;
}
Request parameters
Parameter | Type | Required | Description |
---|---|---|---|
tables | repeated TableInBatchGetRowRequest | Yes |
This parameter specifies the information of rows to be read. The entire operation fails and returns an error if any of the following conditions appears in tables:
|
Response structure
message BatchGetRowResponse {
repeated TableInBatchGetRowResponse tables = 1;
}
Response parameters
Parameter | Type | Description |
---|---|---|
tables | repeated TableInBatchGetRowResponse |
|
CU consumption
- If the entire operation fails, it does not consume any CUs.
- If the request times out and the results are undefined, CUs may or may not be consumed.
- In other situations, each RowInBatchGetRowRequest operation is considered as one GetRow operation when write CUs are calculated. For more information, see GetRow.