Actualizar y eliminar documentos

En Amazon QLDB, la revisión de un documento es una estructura Amazon Ion que representa una versión única de una secuencia de documentos identificados mediante un ID de documento único. Cada revisión contiene el conjunto de datos completo del documento, incluidos los datos de usuario y los metadatos generados por el sistema. Cada revisión se identifica de forma única mediante una combinación del identificador del documento y un número de versión de base cero.

Al actualizar un documento, QLDB crea una nueva revisión con el mismo identificador de documento y un número de versión incrementado. El ciclo de vida de un documento finaliza cuando se elimina de una tabla. Esto significa que no se puede volver a crear ninguna revisión de documento con el mismo identificador de documento.

Realizar revisiones de documentos

Por ejemplo, las siguientes instrucciones insertan un registro de vehículo nuevo, actualizan la ciudad de registro y, a continuación, eliminan el registro. Esto da como resultado tres revisiones de un documento.

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

nota

Las instrucciones insertar y otras instrucciones de DML devuelven el identificador de cada documento afectado. Antes de continuar, guarde este identificador porque lo necesita para la función de historial del tema siguiente. También puede obtener el ID de documento con la siguiente consulta.

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'

Para obtener más ejemplos e información sobre la sintaxis de estas instrucciones de DML, consulte UPDATE y DELETE en la referencia de PartiQL de Amazon QLDB.

Para insertar y eliminar elementos específicos de un documento, puede utilizar instrucciones UPDATE u otras instrucciones de DML que comiencen con la palabra clave FROM. Consulte la referencia FROM (INSERT, REMOVE o SET) para obtener más información y ejemplos.

Tras eliminar un documento, ya no podrá consultarlo en las vistas confirmadas o de usuario. Para obtener información sobre cómo consultar el historial de revisiones de este documento mediante la función de historial integrada, continúe con Consultar el historial de revisiones.