Mise à jour et suppression de documents

Dans Amazon QLDB, une révision de document est une structure Amazon Ion qui représente une version unique d'une séquence de documents identifiés par un identifiant de document unique. Chaque révision contient l'ensemble de données complet du document, y compris vos données utilisateur et les métadonnées générées par le système. Chaque révision est identifiée de manière unique par une combinaison de l'identifiant du document et d'un numéro de version en base zéro.

Lorsque vous mettez à jour un document, QLDB crée une nouvelle révision avec le même identifiant de document et un numéro de version incrémenté. Le cycle de vie d'un document prend fin lorsque vous le supprimez d'un tableau. Cela signifie qu'aucune révision de document avec le même identifiant de document ne peut être créée à nouveau.

Révision des documents

Par exemple, les instructions suivantes insèrent une nouvelle immatriculation du véhicule, mettent à jour la ville d'immatriculation, puis suppriment l'immatriculation. Il en résulte trois révisions d'un document.

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

Note

Les instructions Insert et les autres instructions DML renvoient l'ID de chaque document concerné. Avant de continuer, enregistrez cet identifiant car vous en avez besoin pour la fonction historique de la rubrique suivante. Vous pouvez également trouver l'ID de document à l'aide de la requête suivante.

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'

Pour plus d'exemples et d'informations sur la syntaxe de ces instructions DML, consultezMISE A JOUR etDELETE consultez la référence Amazon QLDB PartiQL.

Pour insérer et supprimer des éléments spécifiques dans un document, vous pouvez utiliserUPDATE des instructions ou d'autres instructions DML qui commencent par leFROM mot clé. Pour plus d'informations et d'exemples, consultez laDE (INSÉRER, SUPPRIMER ou DÉFINIR) référence.

Une fois que vous avez supprimé un document, vous ne pouvez plus l'interroger dans les vues validées ou utilisateur. Pour savoir comment interroger l'historique des révisions de ce document à l'aide de la fonction d'historique intégrée, passez àConsultation de l'historique des révisions.