全部產品
Search
文件中心

Tablestore:刪除單行資料

更新時間:Aug 06, 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

刪除條件,預設不檢查行是否存在。

關於條件的配置方法,請參見條件更新。