Comando DELETE no Amazon QLDB

No Amazon QLDB, use o comando DELETE para marcar um documento ativo como excluído em uma tabela criando uma revisão nova, mas final, do documento. Essa revisão final indica que o documento foi excluído. Essa operação encerra o ciclo de vida de um documento, o que significa que nenhuma outra revisão do documento com a mesma ID do documento pode ser criada.

Essa operação é irreversível. Você ainda pode consultar o histórico de revisão de um documento excluído usando Função de histórico.

nota

Para aprender a controlar o acesso para executar este comando do PartiQL em tabelas específicas, consulte Introdução ao modo de permissões padrão no Amazon QLDB.

Sintaxe

DELETE FROM table_name [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]

Parâmetros

table_name

O nome do usuário da tabela que contém o item a ser excluído. As instruções DML são suportadas somente na visualização padrão do usuário. Cada instrução só pode ser executada em uma única tabela.

AS table_alias

(Opcional) Um alias definido pelo usuário que varia em uma tabela a ser excluída. A palavra-chave AS é opcional.

BY id_alias

(Opcional) Um alias definido pelo usuário que se vincula ao campo de metadados id de cada documento no conjunto de resultados. O alias deve ser declarado na cláusula FROM usando a palavra-chave BY. Isso é útil quando você deseja filtrar a ID do documento ao consultar a visualização padrão do usuário. Para obter mais informações, consulte Usando a cláusula BY para consultar a ID do documento.

WHERE condição

Os critérios de seleção para os documentos a serem excluídos.

nota

Se você omitir a cláusula WHERE, todos os documentos na tabela serão excluídos.

Valor de retorno

documentId— O ID exclusivo de cada documento que você excluiu.

Exemplos

DELETE FROM VehicleRegistration AS r
WHERE r.VIN = '1HVBBAANXWH544237'

Executando programaticamente usando o driver

Para saber como executar programaticamente essa instrução usando o driver QLDB, consulte os seguintes tutoriais em Conceitos básicos do driver:

• Java: Tutorial de início rápido | Referência de Cookbook

• .NET: Tutorial de início rápido | Referência de Cookbook

• Go: Tutorial de início rápido | Referência de Cookbook

• Node.js: Tutorial de início rápido | Referência de Cookbook

• Python: Tutorial de início rápido | Referência de Cookbook