全部产品
Search
文档中心

表格存储:删除单行数据

更新时间:Aug 05, 2026

Java SDK 可按完整主键删除宽表模型数据表中的一行数据。

前提条件

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

功能说明

调用 deleteRow 按完整主键删除一行及其全部属性列数据,可通过 condition 控制删除是否执行。

public DeleteRowResponse deleteRow(DeleteRowRequest deleteRowRequest) throws TableStoreException, ClientException

以下示例删除数据表 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);

client.deleteRow(new DeleteRowRequest(rowDeleteChange));

参数说明

DeleteRowRequest 包含以下参数。

名称

类型

说明

rowChange(必选)

RowDeleteChange

单行删除配置。

transactionId(可选)

String

局部事务 ID。仅在局部事务内删除数据时设置。

关于如何获取和使用该 ID,请参见局部事务。

行变更

rowChange 的类型为 RowDeleteChange,包含以下参数。

名称

类型

说明

tableName(必选)

String

数据表名称。

primaryKey(必选)

PrimaryKey

行主键。必须包含数据表的全部主键列,且列名称、顺序和类型必须与数据表的主键结构一致。主键列支持 STRING、INTEGER 和 BINARY 类型。

condition(可选)

Condition

删除条件,默认不检查行是否存在。

关于条件的配置方法,请参见条件更新。