更新和刪除文件

在 Amazon QLDB 中，文件修訂是 Amazon Ion 結構，代表以唯一文件 ID 識別的一系列文件的單一版本。每個修訂版都包含文件的完整資料集，包括使用者資料和系統產生的中繼資料。每個版本修訂都是由文件 ID 和從零開始的版本編號的組合來唯一識別。

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

修訂文件

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

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' : []
    }
}

注意

Insert 陳述式和其他 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 陳述式語法的詳細範例UPDATE和資訊，請參閱 Amazon QLDB PartiQL 參考資料DELETE中的和。

若要插入和移除文件中的特定元素，您可以使用UPDATE陳述式或其他以FROM關鍵字開頭的 DML 陳述式。如需詳細資訊和範例，請參閱參從 (插入、移除或設定)考資料。

刪除文件後，您將無法再在已提交或使用者檢視中查詢該文件。若要瞭解如何使用內建的歷程記錄功能查詢此文件的修訂歷程記錄，請繼續執行查詢修訂記錄。