如何操作BatchWriteRow-问答-阿里云开发者社区-阿里云

开发者社区> 问答> 正文

如何操作BatchWriteRow

云栖大讲堂 2017-10-25 14:06:12 1455


行为:


批量插入、修改或删除一个或多个表中的若干行数据。
BatchWriteRow 操作可视为多个 PutRow、UpdateRow、DeleteRow 操作的集合。各个操作独立执行,独立返回结果,独立计算服务能力单元。
与执行大量的单行写操作相比,使用 BatchWriteRow 操作可以有效减少请求的响应时间,提高数据的写入速率。

请求结构:message BatchWriteRowRequest {
    repeated TableInBatchWriteRowRequest tables = 1;
}





tables:


  • 类型:repeated TableInBatchWriteRowRequest

  • 是否必要参数:是

  • 指定了需要要执行写操作的行信息。

  • 以下情况都会返回整体错误:
    tables 中任一表不存在。

  • tables 中包含同名的表。

  • tables 中任一表名表名不符合表名命名规范

  • tables 中任一行操作未指定主键、主键列名称不符合规范或者主键列类型不正确。

  • tables 中任一属性列名称不符合列名命名规范

  • tables 中任一行操作存在与主键列同名的属性列。

  • tables 中任一主键列或者属性列的值大小超过上限

  • tables 中任一表中存在主键完全相同的请求。

  • tables 中所有表总的行操作个数超过 200 个,或者其含有的总数据大小超过 4 M。

  • tables 中任一表内没有包含行操作,则返回 OTSParameterInvalidException 的错误。

  • tables 中任一 PutRowInBatchWriteRowRequest 包含的 Column 个数超过 1024 个。

  • tables 中任一 UpdateRowInBatchWriteRowRequest 包含的 ColumnUpdate 个数超过 1024 个。


响应消息结构:message BatchWriteRowResponse {
    repeated TableInBatchWriteRowResponse tables = 1;
}





tables:


  • 类型:TableInBatchWriteRowResponse

  • 对应了每个 table 下各操作的响应信息,包括是否成功执行,错误码和消耗的服务能力单元。

  • 响应消息中 TableInBatchWriteRowResponse 对象的顺序与 BatchWriteRowRequest 中的 TableInBatchWriteRowRequest 对象的顺序相同;每个 TableInBatchWriteRowRequest 中 put_rows、update_rows、delete_rows 包含的 RowInBatchWriteRowResponse 对象的顺序分别与 TableInBatchWriteRowRequest 中 put_rows、update_rows、delete_rows 包含的 PutRowInBatchWriteRowRequest、UpdateRowInBatchWriteRowRequest 和 DeleteRowInBatchWriteRowRequest 对象的顺序相同。

  • 若某行读取失败,该行所对应的 RowInBatchWriteRowResponse 中 is_ok 将为 false。

[backcolor=transparent]注意:BatchWriteRow 操作可能会在行级别部分失败,此时返回的 HTTP 状态码仍为 200。应用程序必须对 RowInBatchWriteRowResponse 中的 error 进行检查,确认每一行的执行结果并进行相应的处理。


服务能力单元消耗:

分享到
取消 提交回答
全部回答(0)
云计算
使用钉钉扫一扫加入圈子
+ 订阅

时时分享云计算技术内容,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。

推荐文章