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

Tablestore:単一のデータ行を削除する

最終更新日:Nov 10, 2025

このトピックでは、Tablestore SDK for Java を使用して Tablestore テーブルから単一のデータ行を削除する方法について説明します。

前提条件

クライアントが初期化されていること。 詳細については、「Tablestore クライアントを初期化する」をご参照ください。

メソッド

public DeleteRowResponse deleteRow(DeleteRowRequest deleteRowRequest) throws TableStoreException, ClientException

DeleteRowRequest パラメーター

  • rowChange (必須) RowDeleteChange: 削除する行の情報。以下のパラメーターを含みます。

    パラメーター

    説明

    tableName (必須)

    String

    データテーブルの名前。

    primaryKey (必須)

    PrimaryKey

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

    • プライマリキー列のデータ型には、STRING、INTEGER、BINARY があります。

    • 指定するプライマリキー列の数と型は、テーブルで定義されているものと一致している必要があります。

    condition (オプション)

    Condition

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

サンプルコード

次のサンプルコードは、test_table テーブルからプライマリキー値が row1 の行を削除します。

public static void deleteRowExample(SyncClient client) {
    // プライマリキーを構築します。
    PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
    primaryKeyBuilder.addPrimaryKeyColumn("id", PrimaryKeyValue.fromString("row1"));
    PrimaryKey primaryKey = primaryKeyBuilder.build();

    // 削除する行データを構築します。
    RowDeleteChange rowDeleteChange = new RowDeleteChange("test_table", primaryKey);

    // deleteRow メソッドを呼び出して、行データを削除します。
    DeleteRowRequest deleteRowRequest = new DeleteRowRequest(rowDeleteChange);
    DeleteRowResponse deleteRowResponse = client.deleteRow(deleteRowRequest);

    // 結果を返します。
    System.out.println("RequestId: " + deleteRowResponse.getRequestId());
    System.out.println("Read CU Cost: " + deleteRowResponse.getConsumedCapacity().getCapacityUnit().getReadCapacityUnit());
    System.out.println("Write CU Cost: " + deleteRowResponse.getConsumedCapacity().getCapacityUnit().getWriteCapacityUnit());
}

関連情報