全部產品
Search
文件中心

Tablestore:刪除單行資料

更新時間:Aug 13, 2026

Go SDK 可刪除寬表模型資料表中指定主鍵的一行資料。

前提條件

安裝Tablestore Go SDK並初始化用戶端。

功能說明

調用 DeleteRow 刪除指定主鍵的一行資料。可以通過 Condition 控制刪除是否執行。

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

以下樣本刪除 example_table 中主索引值為 row1 的一行資料。

primaryKey := &tablestore.PrimaryKey{}
primaryKey.AddPrimaryKeyColumn("id", "row1")

change := &tablestore.DeleteRowChange{
    TableName:  "example_table",
    PrimaryKey: primaryKey,
}
change.SetCondition(tablestore.RowExistenceExpectation_EXPECT_EXIST)

_, err := client.DeleteRow(&tablestore.DeleteRowRequest{DeleteRowChange: change})
if err != nil {
    log.Fatal(err)
}

參數說明

DeleteRowRequest 包含以下參數。

名稱

類型

說明

DeleteRowChange(必選)

*DeleteRowChange

單行刪除配置。

行變更

DeleteRowChange 包含以下參數。

名稱

類型

說明

TableName(必選)

string

資料表名稱。

PrimaryKey(必選)

*PrimaryKey

行主鍵。主鍵列的名稱、順序和類型必須與資料表的主鍵結構一致。

Condition(必選)

*RowCondition

刪除條件。可設定行存在性條件和列條件。更多資訊,請參見條件更新

TransactionId(可選)

*string

局部事務 ID。僅在局部事務內刪除資料時設定。更多資訊,請參見局部事務