表格存储：删除数据

注意事项

删除表数据，将导致数据不可恢复，请谨慎操作。

前提条件

• 已初始化Client，具体操作，请参见初始化OTSClient。

• 已创建数据表并写入数据。具体操作，请参见创建数据表和写入数据。

删除单行数据

调用DeleteRow接口删除一行数据。如果删除的行不存在，则不会发生任何变化。

接口

/// <summary>
/// 指定数据表名称和行的主键，删除一行数据。
/// </summary>
/// <param name="request">请求实例</param>
/// <returns>响应实例</returns>
public DeleteRowResponse DeleteRow(DeleteRowRequest request);

/// <summary>
/// DeleteRow的异步形式。
/// </summary>
public Task<DeleteRowResponse> DeleteRowAsync(DeleteRowRequest request);

参数

示例

以下示例用于删除数据表中的指定行数据。

//要删除的行的PK列分别为0和"abc"。
var primaryKey = new PrimaryKey();
primaryKey.Add("pk0", new ColumnValue(0));
primaryKey.Add("pk1", new ColumnValue("abc"));

try
{
    //构造请求，RowExistenceExpectation.EXPECT_EXIST表示只有此行存在时才执行删除。
    var deleteRowRequest = new DeleteRowRequest("SampleTable", new Condition(RowExistenceExpectation.EXPECT_EXIST), primaryKey);

    //调用DeleteRow接口删除数据。
    otsClient.DeleteRow(deleteRowRequest);

    //如果没有抛出异常，则说明执行成功。
    Console.WriteLine("Delete table succeeded.");
}
catch (Exception ex)
{
    //如果抛出异常，则说明执行失败，处理异常。
    Console.WriteLine("Delete table failed, exception:{0}", ex.Message);
}            

批量删除数据

1. 根据实际选择合适的方式查询待删除数据的主键信息。

   • 如果要删除指定主键范围内的数据，请调用GetRange接口，查询指定主键范围内的数据，并获取待删除数据的主键信息。具体操作，请参见范围读取数据。

   • 如果要删除满足指定条件的数据，请创建多元索引后，使用多元索引查询满足指定条件的数据，并获取待删除数据的主键信息。具体操作，请参见创建多元索引和通过SDK使用多元索引。

2. 调用BatchWriteRow接口，根据主键信息批量删除数据。更多信息，请参见批量写入数据。

相关文档

如果要删除指定天数之前的数据，您可以通过为数据表配置数据生命周期的方式自动清理过期数据。具体操作，请参见数据版本和生命周期。