全部產品
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

行主鍵。必須包含資料表的全部主鍵列,且列名稱、順序和類型必須與資料表的主鍵結構一致。主鍵列支援 STRINGINTEGERBINARY 類型。

condition(可選)

Condition

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

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