全部产品
Search
文档中心

表格存储:删除单行数据

更新时间:May 11, 2026

本文介绍如何使用 .NET SDK 删除表格存储数据表的单行数据。

前提条件

初始化Tablestore Client

方法说明

public DeleteRowResponse DeleteRow(DeleteRowRequest request)

异步方法:

public Task<DeleteRowResponse> DeleteRowAsync(DeleteRowRequest request)

DeleteRowRequest参数说明

名称

类型

说明

tableName(必选)

string

数据表名称。

primaryKey(必选)

PrimaryKey

主键信息,包括主键列名称和主键值。

  • 主键列数据类型包括 STRING、INTEGER 和 BINARY。

  • 主键个数和类型必须与数据表的主键保持一致。

condition(必选)

Condition

删除条件,详情请参见条件更新

示例代码

以下示例代码用于删除 test_table 表中主键值为 row1 的行数据。

try
{
    // 构造主键
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };
    // 删除行数据时必须配置删除条件 (RowExistenceExpectation.IGNORE,表示不做行存在性判断)
    Condition condition = new Condition(RowExistenceExpectation.IGNORE);

    // 调用 DeleteRow 方法删除行数据
    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}");
}

相关文档

批量更新数据