本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon QLDB 中的 DELETE 命令
**重要**
支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱[將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。
在 Amazon QLDB 中，使用 `DELETE`命令，透過建立新的文件最終修訂，在資料表中將作用中文件標記為已刪除。此最終修訂表示文件已刪除。此操作會結束文件的生命週期，這表示無法建立具有相同文件 ID 的進一步文件修訂。
此操作不可復原。您仍然可以使用 查詢已刪除文件的修訂歷史記錄[歷史記錄函數](working.history.md#working.history.function)。
**注意**
若要了解如何控制在特定資料表上執行此 PartiQL 命令的存取，請參閱 [Amazon QLDB 中的標準許可模式入門](getting-started-standard-mode.md)。
**Topics**
+ [語法](#ql-reference.delete.syntax)
+ [參數](#ql-reference.delete.parameters)
+ [傳回值](#ql-reference.delete.return)
+ [範例](#ql-reference.delete.examples)
+ [使用驅動程式以程式設計方式執行](#ql-reference.delete.driver)
## 語法
```
DELETE FROM table_name [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
```
## 參數
***table\$1name***
包含要刪除之資料的使用者資料表名稱。DML 陳述式僅在預設[使用者檢視](working.userdata.md)中受支援。每個陳述式只能在單一資料表上執行。
**AS *table\$1alias***
（選用） 使用者定義的別名，範圍涵蓋要刪除的資料表。`AS` 關鍵字為選用。
**BY *id\$1alias***
（選用） 使用者定義的別名，可繫結至結果集中每個文件的`id`中繼資料欄位。別名必須使用關鍵字在 `FROM`子句中宣告`BY`。當您想要在查詢預設使用者檢視時篩選[文件 ID](working.metadata.md) 時，此功能非常有用。如需詳細資訊，請參閱[使用 BY 子句查詢文件 ID](working.metadata.by-clause.md)。
**WHERE *condition***
要刪除之文件的選取條件。
**注意**
如果您省略 `WHERE`子句，則會刪除資料表中的所有文件。
## 傳回值
`documentId` – 您刪除的每個文件的唯一 ID。
## 範例
```
DELETE FROM VehicleRegistration AS r
WHERE r.VIN = '1HVBBAANXWH544237'
```
## 使用驅動程式以程式設計方式執行
若要了解如何使用 QLDB 驅動程式以程式設計方式執行此陳述式，請參閱*驅動程式入門*中的下列教學課程：
+ Java： [快速入門教學課程](driver-quickstart-java.md) \$1 [技術指南參考](driver-cookbook-java.md)
+ .NET： [快速入門教學課程](driver-quickstart-dotnet.md) \$1 [技術指南參考](driver-cookbook-dotnet.md)
+ Go： [快速入門教學課程](driver-quickstart-golang.md) \$1 [技術指南參考](driver-cookbook-golang.md)
+ Node.js： [快速入門教學課程](driver-quickstart-nodejs.md) \$1 [技術指南參考](driver-cookbook-nodejs.md)
+ Python： [快速入門教學課程](driver-quickstart-python.md) \$1 [技術指南參考](driver-cookbook-python.md)