如何操作PutRow

行为：




插入数据到指定的行，如果该行不存在，则新增一行；若该行存在，则覆盖原有行。



请求消息结构：message PutRowRequest {
    required string table_name = 1;
    required bytes row = 2; // Plainbuffer编码为二进制
    required Condition condition = 3;
    optional ReturnContent return_content = 4;
}




table_name：

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

• 
  类型：bytes
• 
  是否必要参数：是
• 
  写入的行数据， 包括主键和属性列，Plainbuffer格式，编码详见Plainbuffer编码。

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

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

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

• 
  如果该行不存在：
  若指定条件检查为 IGNORE，消耗写服务能力单元的数值为本行的主键数据大小与要插入属性列数据大小之和除以 4 KB 向上取整。
• 
  若指定条件检查为 EXPECT_NOT_EXIST，除了消耗本行的主键数据大小与要插入属性列数据大小之和除以 4 KB 向上取整的写CU，还需消耗该行主键数据大小除以 4 KB 向上取整的读 CU。
• 
  若指定条件检查为 EXPECT_EXIST，本次插入失败并且消耗 1 单位写 CU 和 1 单位读 CU。

• 
  若指定条件检查为 IGNORE，消耗写服务能力单元的数值为本行的主键数据大小与要插入属性列数据大小之和除以 4 KB 向上取整。
• 
  若指定条件检查为 EXPECT_EXIST，除了消耗本行的主键数据大小与要插入属性列数据大小之和除以 4 KB 向上取整的写 CU，还需消耗该行主键数据大小除以 4 KB 向上取整的读 CU。
• 
  若指定条件检查为 EXPECT_NOT_EXIST，本次插入失败并且消耗 1 单位写 CU 和 1 单位读 CU。

• 
  操作成功，按照上述消耗服务能力单元方式进行计算。
• 
  操作失败，则消耗 1 单位写 CU 和 1 单位读 CU。
  关于数据大小的计算请参见产品定价。

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