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

Tablestore:単一行の削除

最終更新日:May 12, 2026

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

前提条件

Tablestore クライアントの初期化

メソッド

public DeleteRowResponse DeleteRow(DeleteRowRequest request)

非同期メソッド:

public Task<DeleteRowResponse> DeleteRowAsync(DeleteRowRequest request)

DeleteRowRequest のパラメーター

パラメーター

説明

tableName (必須)

string

テーブル名。

primaryKey (必須)

PrimaryKey

プライマリキー列の名前と値。

  • プライマリキー列のデータ型は、文字列、整数、またはバイナリである必要があります。

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

condition (必須)

Condition

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

サンプルコード

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

try
{
    // プライマリキーを構築します。
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };
    // 行を削除するには条件が必要です。RowExistenceExpectation.IGNORE は、行が存在するかどうかを確認せずに処理を実行することを示します。
    Condition condition = new Condition(RowExistenceExpectation.IGNORE);

    // 行を削除するリクエストを送信します。
    DeleteRowRequest deleteRowRequest = new DeleteRowRequest("test_table", condition, primaryKey);
    DeleteRowResponse deleteRowResponse = client.DeleteRow(deleteRowRequest);
    Console.WriteLine($"RequestId: {deleteRowResponse.RequestID}");
    Console.WriteLine($"Read CU Cost: {deleteRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"Write CU Cost: {deleteRowResponse.ConsumedCapacityUnit.Write}");
}
catch (Exception ex)
{
    Console.WriteLine($"Delete row failed, exception: {ex.Message}");
}

関連ドキュメント

データの一括書き込み