As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

FROMcomando (INSERTREMOVE,, ouSET) na Amazon QLDB

Na AmazonQLDB, uma declaração que começa com FROM é uma extensão PartiQL que permite inserir e remover elementos específicos em um documento. Você também pode usar essa instrução para atualizar elementos existentes em um documento, semelhante ao comando UPDATE.

Sintaxe

FROM-INSERT

Insira um novo elemento em um documento existente. Para inserir um novo documento de nível superior em uma tabela, você deve usar INSERT.

FROM table_name [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
INSERT INTO element VALUE data [ AT key_name ]

FROM-REMOVE

Remova um elemento existente em um documento ou remova um documento inteiro de nível superior. A última é semanticamente igual à sintaxe DELETE tradicional.

FROM table_name [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
REMOVE element

FROM-SET

Atualize um ou mais elementos em um documento. Se um elemento não existir, ele será inserido. Ela é semanticamente igual à sintaxe UPDATE tradicional.

FROM table_name [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
SET element = data [, element = data, ... ]

Parâmetros

Coleções aninhadas

Embora você possa executar uma DML instrução somente em uma única tabela, você pode especificar coleções aninhadas nos documentos dessa tabela como fontes adicionais. Cada alias que você declara para uma coleção aninhada pode ser usado na cláusula WHERE, SET, INSERT INTO ou cláusula REMOVE.

Por exemplo, as origens FROM da instrução a seguir incluem a tabela VehicleRegistration e a estrutura aninhada Owners.SecondaryOwners.

FROM VehicleRegistration r, @r.Owners.SecondaryOwners o
WHERE r.VIN = '1N4AL11D75C109151' AND o.PersonId = 'abc123'
SET o.PersonId = 'def456'

Este exemplo atualiza o elemento específico da lista SecondaryOwners que tem um PersonId de 'abc123' dentro do documento VehicleRegistration que tem um VIN de '1N4AL11D75C109151'. Essa expressão permite especificar um elemento de uma lista por seu valor em vez de seu índice.

Valor de retorno

documentId: o ID exclusivo de cada documento que você atualizou ou excluiu.

Exemplos

Modifica um elemento em um documento. Se o elemento não existir, ele será inserido.

FROM Vehicle AS v
WHERE v.VIN = '1N4AL11D75C109151' AND v.Color = 'Silver'
SET v.Color = 'Shiny Gray'

Modifica ou insere um elemento e um filtro no campo de metadados id do documento atribuído pelo sistema.

FROM Vehicle AS v BY v_id
WHERE v_id = 'documentId'
SET v.Color = 'Shiny Gray'

Modifica o campo PersonId do primeiro elemento na lista Owners.SecondaryOwners em um documento.

FROM VehicleRegistration AS r
WHERE r.VIN = '1N4AL11D75C109151'
SET r.Owners.SecondaryOwners[0].PersonId = 'abc123'

Remove um elemento existente em um documento.

FROM Person AS p
WHERE p.GovId = '111-22-3333'
REMOVE p.Address

Remove um documento inteiro de uma tabela.

FROM Person AS p
WHERE p.GovId = '111-22-3333'
REMOVE p

Remove o primeiro elemento da lista Owners.SecondaryOwners em um documento na tabela VehicleRegistration.

FROM VehicleRegistration AS r
WHERE r.VIN = '1N4AL11D75C109151'
REMOVE r.Owners.SecondaryOwners[0]

Insere {'Mileage':26500} como um par nome-valor de nível superior em um documento na tabela Vehicle.

FROM Vehicle AS v 
WHERE v.VIN = '1N4AL11D75C109151'
INSERT INTO v VALUE 26500 AT 'Mileage'

Anexa {'PersonId':'abc123'} como um par nome-valor no campo Owners.SecondaryOwners de um documento na tabela VehicleRegistration. Observe que Owners.SecondaryOwners já deve existir e ser um tipo de dados da lista para que essa instrução seja válida. Caso contrário, a palavra-chave AT é exigida na cláusula INSERT INTO.

FROM VehicleRegistration AS r 
WHERE r.VIN = '1N4AL11D75C109151'
INSERT INTO r.Owners.SecondaryOwners VALUE { 'PersonId' : 'abc123' }

Insira {'PersonId':'abc123'} como o primeiro elemento na lista Owners.SecondaryOwners existente em um documento.

FROM VehicleRegistration AS r 
WHERE r.VIN = '1N4AL11D75C109151'
INSERT INTO r.Owners.SecondaryOwners VALUE {'PersonId' : 'abc123'} AT 0

Anexe vários pares de nome-valor à lista Owners.SecondaryOwners existente em um documento.

FROM VehicleRegistration AS r 
WHERE r.VIN = '1N4AL11D75C109151'
INSERT INTO r.Owners.SecondaryOwners << {'PersonId' : 'abc123'}, {'PersonId' : 'def456'} >>

Executar programaticamente usando o driver

Para saber como executar programaticamente essa instrução usando o QLDB driver, consulte os seguintes tutoriais em Introdução ao driver: