適用於 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"
            }
        }
    ]
}