全部產品
Search
文件中心

Tablestore:刪除單行資料

更新時間:Apr 01, 2026

本文介紹如何使用 Go SDK 刪除Table Store資料表的單行資料。

前提條件

初始化Tablestore Client

方法說明

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)
    }
}

相關文檔

批次更新資料