PartiQL for DynamoDB Delete 语句 - Amazon DynamoDB
语法参数返回值示例

PartiQL for DynamoDB Delete 语句

使用 DELETE 语句从 Amazon DynamoDB 表中删除现有项目。

注意

一次只能删除一个项目。不能发出单个 DynamoDB PartiQL 语句，删除多个项目。有关删除多个项目的信息，请参阅 使用 PartiQL for DynamoDB 执行事务 或 对 PartiQL for DynamoDB 运行批处理操作。

语法

DELETE FROM table 
 WHERE condition [RETURNING returnvalues]
 <returnvalues>  ::= ALL OLD *

参数

table

（必需）包含要删除的项目的 DynamoDB 表。

condition

（必需）要删除的项目的选择条件；此条件必须解析为单个主键值。

returnvalues

（可选）如果要获得删除前的项目属性，请使用 returnvalues。有效值为：

  • ALL OLD * - 返回旧项目的内容。

返回值

此语句不返回值，除非指定 returnvalues 参数。

注意

如果 DynamoDB 表中没有任何与发出 DELETE 的项目的主键相同的项目，则返回 SUCCESS 并删除 0 个项目。如果表具有具有相同主键的项目，但 DELETE 语句的 WHERE 子句中的条件计算结果为 false，则返回 ConditionalCheckFailedException。

示例

以下查询删除 "Music" 表中的一个项目。

DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks'

您可以添加参数 RETURNING ALL OLD * 以返回已删除的数据。

DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks' RETURNING ALL OLD *

Delete 语句现在返回以下内容：

{
    "Items": [
        {
            "Artist": {
                "S": "Acme Band"
            },
            "SongTitle": {
                "S": "PartiQL Rocks"
            }
        }
    ]
}