適用於 DynamoDB 的 PartiQL Delete 陳述式 - Amazon DynamoDB

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

適用於 DynamoDB 的 PartiQL Delete 陳述式

使用 DELETE 陳述式從您的 Amazon DynamoDB 資料表中刪除現有項目。

注意

您一次只能刪除一個項目。您無法發出可刪除多個項目的單個 DynamoDB PartiQL 陳述式。如需刪除多個項目的相關資訊,請參閱 使用 DynamoDB 專用 PartiQL 執行交易使用 DynamoDB 專用 PartiQL 執行批次操作

語法

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

參數

表格

(必要) 包含要刪除之項目的 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" } } ] }