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

Tablestore:行の削除

最終更新日:Jun 26, 2026

プライマリキーを使用してデータテーブルから行を検索し、削除します。行の状態が削除前に一致する必要がある場合は、条件を使用して削除を制御します。

前提条件

Tablestore SDK for Java をインストールし、クライアントを初期化します。

説明

public DeleteRowResponse deleteRow(DeleteRowRequest deleteRowRequest) throws TableStoreException, ClientException

プライマリキーで指定された単一の行を削除します。プライマリキーは RowDeleteChange で指定します。応答から response.getConsumedCapacity() を使用して、消費された容量単位 (CU) を取得できます。

次の例では、データテーブル 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);

DeleteRowResponse response = client.deleteRow(new DeleteRowRequest(rowDeleteChange));
System.out.println("RequestId: " + response.getRequestId());
System.out.println("Write CU: " + response.getConsumedCapacity().getCapacityUnit().getWriteCapacityUnit());

主要なパラメーター

  • tableName (必須):ターゲットデータテーブルの名前。

  • primaryKey (必須):プライマリキー。すべてのプライマリキー列を含める必要があります。

パラメーター

単一行の削除の詳細は、RowDeleteChange で以下のパラメーターを使用して渡します。

名前

説明

tableName (必須)

String

ターゲットデータテーブルの名前。

primaryKey (必須)

PrimaryKey

行のプライマリキー。列名と値を含みます。

  • サポートされているプライマリキー列の型:STRING、INTEGER、BINARY。

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

condition (オプション)

Condition

削除を制御する条件。詳細については、「条件付き更新」をご参照ください。

参考