您可以使用DeleteRow接口删除一行数据。
请求消息结构
message DeleteRowRequest {
required string table_name = 1;
required bytes primary_key = 2; // Plainbuffer编码为二进制
required Condition condition = 3;
optional ReturnContent return_content = 4;
}
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
table_name | string | 是 | 请求更新数据的表名。 |
primary_key | bytes | 是 | 删除行的主键,Plainbuffer格式,编码详见Plainbuffer编码。 |
condition | Condition | 是 |
|
return_content | ReturnContent | 否 | 写入成功后返回的数据类型。目前仅支持返回主键,主要用于主键列自增功能中。 |
响应消息结构
message DeleteRowResponse {
required ConsumedCapacity consumed = 1;
optional bytes row = 2;
}
名称 | 类型 | 描述 |
---|---|---|
consumed | ConsumedCapacity | 本次操作消耗的服务能力单元。 |
row | bytes |
|
服务能力单元消耗
-
如果该行不存在:
-
若指定条件检查为 IGNORE,消耗写服务能力单元的数值为该行主键数据大小除以 4 KB 向上取整。
-
若指定条件检查为 EXPECT_EXIST,删除该行失败,消耗 1 单位的写 CU 和 1 单位的读 CU。
-
-
如果该行存在:
-
若指定条件检查为 IGNORE,消耗写服务能力单元的数值为该行主键数据大小除以 4 KB 向上取整。
-
若指定条件检查为 EXPECT_EXIST,除了消耗该行主键数据大小除以 4 KB 向上取整的写 CU,还需消耗该行主键数据大小除以 4 KB 向上取整的读 CU。
关于数据大小的计算请参见产品定价。
-
-
如果返回内部错误(HTTP 状态码:5XX),则此次操作不消耗服务能力单元;其他错误情况消耗 1 个写服务能力单元。
-
如果请求超时,结果未定义,服务能力单元有可能被消耗,也可能未被消耗。
在文档使用中是否遇到以下问题
更多建议
匿名提交