Mettre à jour et supprimer des documents

Dans AmazonQLDB, 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 le jeu 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'ID du document et d'un numéro de version à base zéro.

Lorsque vous mettez à jour un document, il 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 portant le même identifiant de document ne peut être créée à nouveau.

Révision de documents

Par exemple, les instructions suivantes insèrent une nouvelle immatriculation de véhicule, mettent à jour la ville d'immatriculation, puis suppriment l'immatriculation. Cela donne lieu à 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' : []
    }
}

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 DML instructions, consultez UPDATE et DELETE dans la référence Amazon QLDB partiQL.

Pour insérer et supprimer des éléments spécifiques dans un document, vous pouvez utiliser UPDATE des instructions ou d'autres DML instructions commençant par le FROM mot clé. Pour plus d'informations et des exemples, consultez la FROM(INSERTREMOVE, ouSET) référence.

Une fois que vous avez supprimé un document, vous ne pouvez plus l'interroger dans les vues de validation ou d'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.