全部產品
Search
文件中心

Tablestore:通過 SQL 刪除資料

更新時間:Jul 31, 2026

通過 Java SDK 執行 DELETE 語句,刪除未開啟局部事務功能的資料表中的單行資料。

前提條件

  • 安裝Tablestore Java SDK並初始化用戶端。

  • 使用 5.17.11 及以上版本的 Tablestore Java SDK。

  • 已為待刪除資料的資料表建立映射關係,且資料表未開啟局部事務功能。

  • 使用 RAM 使用者時,已授予 SQL_DML 許可權。

功能說明

調用 sqlQuery 方法執行 DELETE 語句,刪除一行資料。WHERE 子句必須使用等值條件指定全部主鍵列。

SQLQueryResponse sqlQuery(SQLQueryRequest request)

以下樣本刪除 example_table 資料表中主索引值為 1 和 row1 的一行資料。

String query = "DELETE FROM example_table "
        + "WHERE tenant_id = 1 AND pk = 'row1'";
SQLQueryRequest request = new SQLQueryRequest(query);

SQLQueryResponse response = client.sqlQuery(request);
System.out.println("Affected rows: " + response.getAffectedRows());

參數說明

SQLQueryRequest 包含以下參數。

名稱

類型

說明

query(必選)

String

要執行的 DELETE 語句。WHERE 子句使用等值條件指定全部主鍵列。

傳回值

SQLQueryResponse 包含以下與刪除結果相關的欄位。

欄位

類型

說明

affectedRows

long

通過 getAffectedRows() 擷取成功刪除的行數。目標行存在時返回 1;目標行不存在時返回 0。

consumedCapacityByTable

Map<String, ConsumedCapacity>

通過 getConsumedCapacity() 擷取各資料表消耗的讀寫 CU。服務端校正待刪除資料時消耗讀 CU,刪除資料時消耗寫 CU。

type

SQLStatementType

通過 getSQLStatementType() 擷取 SQL 陳述式類型。執行 DELETE 語句時返回 SQL_DELETE。