すべてのプロダクト
Search
ドキュメントセンター

Tablestore:単一行データの削除

最終更新日:Mar 10, 2026

テーブル名とプライマリキーを指定して、Tablestore テーブルから単一行を削除します。

事前準備

Tablestore クライアントの初期化

メソッド

public function deleteRow(array $request)

$request パラメーター

名前

説明

table_name (必須)

文字列

データテーブルの名前です。

primary_key (必須)

配列

削除対象行のプライマリキーで、プライマリキー列の名前と値を含みます。

  • プライマリキー列のデータの型は、STRING、INTEGER、または BINARY です。

  • プライマリキーの数および型は、データテーブルの定義と一致している必要があります。

condition (必須)

配列

削除操作の条件です。詳細については、「条件付き更新」をご参照ください。

transaction_id (オプション)

文字列

ローカルトランザクション ID です。この 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.";
}

参考

データの一括更新