在 BatchWriteRow 操作中,表示要读取的一行请求信息。
数据结构message RowInBatchWriteRowRequest {
required OperationType type = 1;
required bytes row_change = 2; // encoded as InplaceRowChangeSet
required Condition condition = 3;
optional ReturnContent return_content = 4;
}
type:
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在阿里云表格存储(Table Store,原OTS)中,BatchWriteRow
是一个批量操作接口,允许用户在一个请求中执行多行数据的插入、更新或删除操作,这有助于减少网络交互次数,提高数据写入效率。您提供的数据结构描述了在进行 BatchWriteRow
操作时,单个行请求 (RowInBatchWriteRowRequest
) 的详细信息。下面是对这个数据结构各字段的解释和相关操作的进一步说明:
type (OperationType): 这个字段指定了对这一行数据要执行的操作类型。OperationType
可以是以下几种:
PUT
:插入或更新一行数据。如果该行已存在,则更新;如果不存在,则插入。UPDATE
:根据给定条件更新一行数据中的部分列。DELETE
:删除一行数据。row_change (bytes): 此字段包含了行数据的变更信息,包括主键和其他属性列。这些数据使用 Plainbuffer 编码格式封装,Plainbuffer 是一种高效的二进制序列化格式,适合于网络传输和存储。row_change
包含了实际要写入或修改的数据内容。
condition (Condition): 条件更新时使用的条件表达式。它允许你指定只有当满足某些条件时才执行操作,比如只有当某列的值等于特定值时才执行更新。这可以用来实现乐观锁机制,防止并发写入冲突。
return_content (ReturnContent, optional): 这是一个可选参数,用于指定在操作成功后是否需要返回某些额外信息。例如,你可以选择返回受影响行的主键,这对于确认哪些行被成功处理很有帮助。可能的选项包括:
RETURN_NONE
: 不返回任何内容。RETURN_PRIMARY_KEY
: 仅返回主键。RETURN_ALL_OLD
: 返回操作前的旧数据(仅适用于UPDATE操作)。相关操作: - BatchWriteRow: 这是实际发起批量写入请求的操作。在这个操作中,你会提供一个包含多个 RowInBatchWriteRowRequest
结构的列表,每个结构定义了一次针对单行的具体操作。表存储服务会尽可能地并行处理这些请求,并返回每个操作的结果,包括是否成功以及(如果设置了 return_content
)相应的返回内容。
通过合理利用 BatchWriteRow
接口,开发者能够高效地管理大量数据的写入,特别是在大数据处理、日志记录、物联网(IoT)数据收集等场景下。