如何操作UpdateRow

行为：


更新指定行的数据。如果该行不存在，则新增一行；若该行存在，则根据请求的内容在这一行中新增、修改或者删除指定列的值。

请求消息结构：message UpdateRowRequest {
    required string table_name = 1;
    required bytes row_change = 2;
    required Condition condition = 3;
    optional ReturnContent return_content = 4;
}




table_name：

• 
  类型： string
• 
  是否必要参数： 是
• 
  请求更新数据的表名。

• 
  类型：bytes
• 
  是否必要参数： 是
• 
  更新的数据，包括主键和属性列，Plainbuffer格式，编码详见Plainbuffer编码。
• 
  该行本次想要更新的全部属性列，表格存储会根据 row_change中UpdateType的内容在这一行中新增、修改或者删除指定列的值。
• 
  该行已经存在的不在 row_change 中的列将不受影响。
• 
  UpdateType 可以取下面两个值：
  PUT：此时value 必须为有效的属性列值。语意为如果该列不存在，则新增一列；如果该列存在，则覆盖该列。
• 
  DELETE：此时该 value 必须为空，需要指定timestamp。语意为删除该列特定版本的数据。
• 
  DELETE_ALL：此时该 value 和timestamp 都必须为空。语意为删除该列所有版本的数据。

[backcolor=transparent]注意：删除本行的全部属性列不等同于删除本行，若想删除本行，请使用 DeleteRow 操作。

• 
  类型：Condition
• 
  是否必要参数： 是
• 
  在数据更新前是否进行存在性检查，可以取下面两个值：
  IGNORE 表示不做行存在性检查。
• 
  EXPECT_EXIST 表示期望行存在。

• 
  类型：ReturnContent
• 
  是否必要参数：否
• 
  写入成功后返回的数据类型，目前仅支持返回主键，主要用于主键列自增功能中。

• 
  类型：ConsumedCapacity
• 
  本次操作消耗的服务能力单元。

• 
  如果该行不存在：
  若指定条件检查为 IGNORE，消耗写服务能力单元的数值为本行的主键数据大小与要更新的属性列数据大小之和除以 4 KB 向上取整。如果 UpdateRow 中包含有需要删除的属性列，只有其列名长度计入该属性列数据大小。
• 
  若指定条件检查为 EXPECT_EXIST，本次插入失败并且消耗 1 单位写 CU 和 1 单位读 CU。

• 
  若指定条件检查为 IGNORE，消耗写服务能力单元的数值为本行的主键数据大小与要更新的属性列数据大小之和除以 4 KB 向上取整。如果 UpdateRow 中包含有需要删除的属性列，只有其列名长度计入该属性列数据大小。
• 
  若指定条件检查为 EXPECT_EXIST，除了需要消耗在条件检查为 IGNORE 情况下的写 CU，还需消耗该行主键数据大小除以 4 KB 向上取整的读 CU。
  关于数据大小的计算请参见产品定价。

• 
  类型：bytes
• 
  当设置了return_content后，返回的数据。
• 
  如果没设置return_content或者没返回值，此处为NULL。
• 
  Plainbuffer格式，编码详见Plainbuffer编码。