BatchGetRow - 表格存储 Tablestore

BatchGetRow 操作可视为多个 GetRow 操作的集合，各个操作独立执行，独立返回结果，独立计算服务能力单元。

与执行大量的 GetRow 操作相比，使用 BatchGetRow 操作可以有效减少请求的响应时间，提高数据的读取速率。

请求结构

message BatchGetRowRequest {
    repeated TableInBatchGetRowRequest tables = 1;
}


参数	类型	是否必需	描述
tables	repeated TableInBatchGetRowRequest	是	指定了需要要读取的行信息。若 tables 中出现了下述情况，则操作整体失败，返回错误。 tables 中任一表不存在。 tables 中任一表名不符合命名规则和数据类型。 tables 中任一行未指定主键、主键名称不符合规范或者主键类型不正确。 tables 中任一表的 columns_to_get 内的列名不符合命名规则和数据类型。 tables 中包含同名的表。 tables 中任一表内包含主键完全相同的行。所有 tables 中 RowInBatchGetRowRequest 的总个数超过 100 个。 tables 中任一表内不包含任何 RowInBatchGetRowRequest。 tables 中任一表的 columns_to_get 超过 128 列。

message BatchGetRowResponse {
    repeated TableInBatchGetRowResponse tables = 1;
}

说明 BatchGetRow 操作可能会在行级别部分失败，此时返回的 HTTP 状态码仍为 200。应用程序必须对 RowInBatchGetRowResponse 中的 error 进行检查确认每一行的执行结果，并进行相应的处理。


参数	类型	描述
tables	repeated TableInBatchGetRowResponse	对应了每个 table 下读取到的数据。响应消息中 TableInBatchGetRowResponse 对象的顺序与 BatchGetRowRequest 中的 TableInBatchGetRowRequest 对象的顺序相同；每个 TableInBatchGetRowResponse 下面的 RowInBatchGetRowResponse 对象的顺序与 TableInBatchGetRowRequest 下面的 RowInBatchGetRowRequest 相同。如果某行不存在或者某行在指定的 columns_to_get 下没有数据，仍然会在 TableInBatchGetRowResponse 中有一条对应的 RowInBatchGetRowResponse，但其 row 下面的 primary_key_columns 和 attribute_columns 将为空。若某行读取失败，该行所对应的 RowInBatchGetRowResponse 中 is_ok 将为 false，此时 row 将为空。

如果本次操作整体失败，不消耗任何服务能力单元。
如果请求超时，结果未定义，服务能力单元有可能被消耗，也可能未被消耗。
其他情况将每个 RowInBatchGetRowRequest 视为一个 GetRow 操作独立计算写服务能力单元，具体请参考 GetRow 服务能力单元消耗。