Atualizando e excluindo documentos

Em Amazon Ion, uma revisão de documento é uma estrutura Amazon Ion que representa uma única versão de uma sequência de documentos identificados por um ID de documento exclusivo. Cada revisão contém o conjunto de dados completo do documento, incluindo os dados do usuário e os metadados gerados pelo sistema. Cada revisão está associada a uma tabela e é identificada exclusivamente por uma combinação da ID do documento e um número de versão baseado em zero.

Quando você atualiza um documento, o QLDB cria uma nova revisão com o mesmo ID do documento e um número de versão incrementado. O ciclo de vida de um documento termina quando você o exclui de uma tabela. Isso significa que nenhuma revisão de documento com a mesma ID de documento pode ser criada novamente.

Fazendo revisões de documentos

Por exemplo, as instruções a seguir inserem um novo registro de veículo, atualizam a cidade de registro e, em seguida, excluem o registro. Isso resulta em três revisões de um 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

As instruções de inserção e outras instruções DML retornam a ID de cada documento afetado. Antes de continuar, salve esse ID porque você precisa dele para a função de histórico no próximo tópico. Você também pode encontrar o ID do documento com a consulta a seguir.

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 obter mais exemplos e informações sobre a sintaxe dessas instruções DML, consulte UPDATE e DELETE na referência do Amazon QLDB PartiQL.

Para inserir e remover elementos específicos em um documento, você pode usar instruções UPDATE ou outras instruções DML que comecem com a palavra-chave FROM. Consulte a referência de FROM (INSERIR, REMOVER ou DEFINIR) para obter mais informações e exemplos.

Depois de excluir um documento, você não poderá mais consultá-lo nas visualizações confirmada ou de usuário. Para saber como consultar o histórico de revisões deste documento usando a função de histórico integrada, vá para Consultando o histórico de revisões.