删除单行数据

更新时间:
复制 MD 格式

Java SDK 按主键删除数据表中的单行数据,支持按条件删除(如行存在时才删除),适用于精确清理单条记录的场景。

前提条件

安装 Tablestore Java SDK并初始化客户端。

功能说明

public DeleteRowResponse deleteRow(DeleteRowRequest deleteRowRequest) throws TableStoreException, ClientException

按主键定位单行后整行删除。通过 RowDeleteChange 携带主键,结果通过 response.getConsumedCapacity() 获取消耗 CU。

以下示例删除数据表 delete_row_demo 中主键值为 row1 的行。

String tableName = "delete_row_demo";

PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
primaryKeyBuilder.addPrimaryKeyColumn("id", PrimaryKeyValue.fromString("row1"));
PrimaryKey primaryKey = primaryKeyBuilder.build();

RowDeleteChange rowDeleteChange = new RowDeleteChange(tableName, primaryKey);

DeleteRowResponse response = client.deleteRow(new DeleteRowRequest(rowDeleteChange));
System.out.println("RequestId: " + response.getRequestId());
System.out.println("Write CU: " + response.getConsumedCapacity().getCapacityUnit().getWriteCapacityUnit());

关键参数

  • tableName(必选):删除的数据表名称。

  • primaryKey(必选):主键信息,必须包含全部主键列。

参数说明

通过 RowDeleteChange 携带单行删除信息,各参数说明如下。

名称

类型

说明

tableName(必选)

String

删除的数据表名称。

primaryKey(必选)

PrimaryKey

行的主键信息,包括主键列名称和主键值。

  • 主键列数据类型包括 STRING、INTEGER 和 BINARY。

  • 主键个数和类型必须与数据表的主键 schema 保持一致。

condition(可选)

Condition

删除操作的执行条件,详情请参见条件更新

相关文档