全部產品
Search
文件中心

Tablestore:刪除單行資料

更新時間:Mar 10, 2026

本文介紹如何使用 PHP SDK 刪除Table Store資料表的單行資料。

前提條件

初始化Tablestore Client

方法說明

public function deleteRow(array $request)

$request參數說明

名稱

類型

說明

table_name(必選)

string

資料表名稱。

primary_key(必選)

array

主鍵資訊,包括主鍵列名稱和主索引值。

  • 主鍵列資料類型包括 STRING、INTEGER 和 BINARY。

  • 主鍵個數和類型必須與資料表的主鍵保持一致。

condition(必選)

array

刪除條件,詳情請參見條件更新

transaction_id(可選)

string

局部事務ID,用於唯一標識局部事務,詳情請參見局部事務

範例程式碼

以下範例程式碼用於刪除 test_table 表中主索引值為 row1 的行資料。

try{
    $response = $client->deleteRow(array (
        'table_name' => 'test_table',
        'primary_key' => array (
            array ('id', 'row1')
        ),
        // 刪除行資料時必須配置刪除條件 (RowExistenceExpectationConst::CONST_IGNORE,表示不做行存在性判斷)
        'condition' => RowExistenceExpectationConst::CONST_IGNORE
    ));

    echo "Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
} catch (Exception $e) {
    echo "Delete Row failed.";
}

相關文檔

批次更新資料