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

# 更新和刪除文件
<a name="working.revisions"></a>

**重要**  
支援終止通知：現有客戶將可以使用 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 中，*文件修訂*是 Amazon Ion 結構，代表由唯一文件 ID 識別的一系列文件的單一版本。每個修訂都包含文件的完整資料集，包括您的使用者資料和系統產生的中繼資料。每個修訂都是由文件 ID 和零基版本編號的組合唯一識別。

當您更新文件時，QLDB 會使用相同的文件 ID 和遞增的版本編號建立新的修訂。從資料表刪除文件時，文件的生命週期會結束。這表示無法再次建立具有相同文件 ID 的文件修訂版。

## 進行文件修訂
<a name="working.revisions.making"></a>

例如，下列陳述式會插入新車輛註冊、更新註冊城市，然後刪除註冊。這會導致文件的三個修訂。

```
INSERT INTO VehicleRegistration
{
    'VIN' : '1HVBBAANXWH544237',
    'LicensePlateNumber' : 'LS477D',
    'State' : 'WA',
    'City' : 'Tacoma',
    'PendingPenaltyTicketAmount' : 42.20,
    'ValidFromDate' : `2011-10-26T`,
    'ValidToDate' : `2023-09-25T`,
    'Owners' : {
        'PrimaryOwner' : { 'PersonId': 'KmA3XPKKFqYCP2zhR3d0Ho' },
        'SecondaryOwners' : []
    }
}
```

**注意**  
插入陳述式和其他 DML 陳述式會傳回每個受影響文件的 ID。在繼續之前，請儲存此 ID，因為下一個主題需要它來做為歷史記錄函數。您也可以使用下列查詢找到文件 ID。  

```
SELECT r_id FROM VehicleRegistration AS r BY r_id
WHERE r.VIN = '1HVBBAANXWH544237'
```

```
UPDATE VehicleRegistration AS r 
SET r.City = 'Bellevue' 
WHERE r.VIN = '1HVBBAANXWH544237'
```

```
DELETE FROM VehicleRegistration AS r 
WHERE r.VIN = '1HVBBAANXWH544237'
```

如需這些 DML 陳述式語法的更多範例和資訊，請參閱 *Amazon QLDB PartiQL 參考*[DELETE](ql-reference.delete.md)中的 [UPDATE](ql-reference.update.md)和 。

若要在文件中插入和移除特定元素，您可以使用以`FROM`關鍵字開頭的`UPDATE`陳述式或其他 DML 陳述式。如需資訊和範例，請參閱 [FROM (INSERT、Remove 或 SET)](ql-reference.from.md)參考。

刪除文件後，您無法再在遞交或使用者檢視中查詢該文件。若要了解如何使用內建歷史記錄函數查詢本文件的修訂歷史記錄，請繼續[查詢修訂歷史記錄](working.history.md)。