Table Store Python SDK 刪除單行資料 - Tablestore

使用 Python SDK 按主鍵刪除單行資料，並按需設定刪除條件或局部事務。

前提條件

功能說明

調用 delete_row 方法按主鍵刪除整行資料。

def delete_row(
    self,
    table_name,
    row=None,
    condition=None,
    return_type=None,
    transaction_id=None,
    **kwargs,
)

以下樣本刪除 example_table 中主鍵為 ("device", 1) 的一行資料。

primary_key = [("partition", "device"), ("id", 1)]
row = Row(primary_key)
condition = Condition(RowExistenceExpectation.EXPECT_EXIST)

consumed, return_row = client.delete_row(
    "example_table",
    row,
    condition,
)
print("Write CU: %s" % consumed.write)

參數說明

delete_row 方法包含以下參數。

名稱	類型	說明
table_name（必選）	`str`	資料表名稱。
row（必選）	`Row`	待刪除行的主鍵。`Row.primary_key` 必須包含全部主鍵列，且主鍵列的名稱、順序、數量和類型與資料表的主鍵結構一致。
condition（可選）	`Condition`	刪除條件。預設不判斷行是否存在。有關配置方法，請參見條件更新。
return_type（可選）	`ReturnType`	傳回型別。`RT_NONE`（預設值）表示不返回資料；`RT_PK` 表示返回主鍵列。
transaction_id（可選）	`str`	局部事務 ID。僅在局部事務內刪除資料時設定。有關使用方法，請參見局部事務。

傳回值

delete_row 返回以下值。

欄位	類型	說明
consumed	`CapacityUnit`	本次操作消耗的讀寫 CU。
return_row	`Row`	返回的行資料。`return_type` 為 `RT_PK` 時返回主鍵列，否則為 `None`。