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

Tablestore:単一行の削除

最終更新日:Apr 01, 2026

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

前提条件

Tablestore クライアントの初期化

メソッド

func (tableStoreClient *TableStoreClient) DeleteRow(request *DeleteRowRequest) (*DeleteRowResponse, error)

DeleteRowRequest パラメーター

  • DeleteRowChange (必須)*DeleteRowChange:削除する行を指定します。このパラメーターには、以下のパラメーターが含まれます。

    パラメーター

    説明

    TableName (必須)

    string

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

    PrimaryKey (必須)

    PrimaryKey

    行のプライマリキーです。プライマリキー列の名前と値が含まれます。

    • 有効なプライマリキー列のデータ型は、STRING、INTEGER、および BINARY です。

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

    Condition (必須)

    RowCondition

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

    TransactionId (オプション)

    string

    ローカルトランザクションの一意の ID です。詳細については、「ローカルトランザクション」をご参照ください。

サンプルコード

以下のサンプルコードは、「test_table」データテーブルからプライマリキー値「row1」を持つ行を削除します。

func DeleteRowSample(client *tablestore.TableStoreClient) {
    // プライマリキーを構築します。
    deletePk := new(tablestore.PrimaryKey)
    deletePk.AddPrimaryKeyColumn("id", "row1")

    // 削除する行を構築します。
    deleteRowChange := new(tablestore.DeleteRowChange)
    deleteRowChange.TableName = "test_table"
    deleteRowChange.PrimaryKey = deletePk 
    // 削除操作の条件を指定する必要があります。RowExistenceExpectation_IGNORE は、行の存在チェックをスキップします。
    deleteRowChange.SetCondition(tablestore.RowExistenceExpectation_IGNORE)

    // DeleteRow メソッドを呼び出して行を削除します。
    deleteRowReq := new(tablestore.DeleteRowRequest)
    deleteRowReq.DeleteRowChange = deleteRowChange
    response, err := client.DeleteRow(deleteRowReq)
    if err != nil {
        fmt.Println("Delete row failed with error: ", err)
    } else {
        fmt.Printf("RequestId: %s \n", response.RequestId)
        fmt.Printf("Read CU Cost: %d \n", response.ConsumedCapacityUnit.Read)
        fmt.Printf("Write CU Cost: %d \n", response.ConsumedCapacityUnit.Write)
    }
}

関連トピック

データのバッチ書き込み