プライマリキーを使用してデータテーブルから行を検索し、削除します。行の状態が削除前に一致する必要がある場合は、条件を使用して削除を制御します。
前提条件
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 |
行のプライマリキー。列名と値を含みます。
|
|
condition (オプション) |
Condition |
削除を制御する条件。詳細については、「条件付き更新」をご参照ください。 |