PartiQL for DynamoDB Delete 语句 - Amazon DynamoDB
语法参数返回值示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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"
            }
        }
    ]
}