Dokumente aktualisieren und löschen

In Amazon QLDB ist eine Dokumentrevision eine Amazon Ion-Struktur, die eine einzelne Version einer Sequenz von Dokumenten darstellt, die durch eine eindeutige Dokument-ID identifiziert werden. Jede Revision enthält den vollständigen Datensatz des Dokuments, einschließlich Ihrer Benutzerdaten und systemgenerierter Metadaten. Jede Revision wird eindeutig durch eine Kombination aus Dokument-ID und nullbasierter Versionsnummer identifiziert.

Wenn Sie ein Dokument aktualisieren, erstellt QLDB eine neue Revision mit derselben Dokument-ID und einer inkrementierten Versionsnummer. Der Lebenszyklus eines Dokuments endet, wenn Sie es aus einer Tabelle löschen. Das bedeutet, dass keine Dokumentrevision mit derselben Dokument-ID erneut erstellt werden kann.

Änderungen an Dokumenten vornehmen

Beispiel: Die folgenden Anweisungen fügen eine neue Fahrzeugzulassung ein, aktualisieren die Stadt der Zulassung und löschen die Zulassung. Dies führt zu drei Revisionen eines Dokuments.

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

Anmerkung

Insert-Anweisungen und andere DML-Anweisungen geben die ID jedes betroffenen Dokuments zurück. Bevor Sie fortfahren, speichern Sie diese ID, da Sie sie für die Verlaufsfunktion im nächsten Thema benötigen. Sie können die Dokument-ID auch mit der folgenden Abfrage finden.

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'

Weitere Beispiele und Informationen zur Syntax dieser DML-Anweisungen finden Sie unterUPDATE undDELETE in der Amazon QLDB PartiQL-Referenz.

Um bestimmte Elemente in ein Dokument einzufügen und zu entfernen, können SieUPDATE Anweisungen oder andere DML-Anweisungen verwenden, die mit demFROM Schlüsselwort beginnen. Weitere Informationen und Beispiele finden Sie in derVON (INSERT, REMOVE oder SET) Referenz.

Nachdem Sie ein Dokument gelöscht haben, können Sie es nicht mehr in der bestätigten oder Benutzeransicht abfragen. Weitere Informationen zur Abfrage des Versionsverlaufs dieses Dokuments mithilfe der integrierten Verlaufsfunktion finden Sie unter Abfragen des Revisionsverlaufs.