PartiQL 删除 的语句 DynamoDB - Amazon DynamoDB
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

PartiQL 删除 的语句 DynamoDB

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

注意

一次只能删除一个项目。您无法发出删除多个项目的单个 DynamoDB PartiQL 语句。有关删除多个项目的信息,请参阅使用适用于 PartiQL 的 DynamoDB 执行事务使用适用于 PartiQL 的 DynamoDB 运行批量操作

Syntax

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

Parameters

table

(必需)包含要删除的项目的 DynamoDB 表。

condition

(必需)要删除的项目的选择条件;此条件必须解析为单个主键值。

returnvalues

(可选)如果您希望获取项目属性在被删除前显示的属性,请使用 returnvalues。有效值为:

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

返回值

除非指定了 returnvalues 参数,否则该语句不会返回值。

注意

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

Examples

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