删除单行数据

更新时间:
复制为 MD 格式

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

前提条件

初始化Tablestore Client

方法说明

public function deleteRow(array $request)

$request参数说明

名称

类型

说明

table_name(必选)

string

数据表名称。

primary_key(必选)

array

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

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

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

condition(必选)

array

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

transaction_id(可选)

string

局部事务ID,用于唯一标识局部事务,详情请参见局部事务

示例代码

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

try{
    $response = $client->deleteRow(array (
        'table_name' => 'test_table',
        'primary_key' => array (
            array ('id', 'row1')
        ),
        // 删除行数据时必须配置删除条件 (RowExistenceExpectationConst::CONST_IGNORE,表示不做行存在性判断)
        'condition' => RowExistenceExpectationConst::CONST_IGNORE
    ));

    echo "Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
} catch (Exception $e) {
    echo "Delete Row failed.";
}

相关文档

批量更新数据