INSERTcomando na Amazon QLDB - Banco de dados Amazon Quantum Ledger (AmazonQLDB)
SintaxeParâmetrosValor de retornoExemplosExecutar programaticamente usando o driver

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á.

INSERTcomando na Amazon QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

Na AmazonQLDB, use o INSERT comando para adicionar um ou mais documentos Amazon Ion a uma tabela.

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 na Amazon QLDB.

Sintaxe

Insira um único documento.

INSERT INTO table_name VALUE document

Insira vários documentos.

INSERT INTO table_name << document, document, ... >>

Parâmetros

table_name

O nome da tabela de usuário na qual você deseja qual inserir os dados. A tabela já deve existir. DMLas declarações só são suportadas na visualização padrão do usuário.

document

Um QLDBdocumento válido. Você deve especificar pelo menos um documento. Vários documentos devem ser separados por vírgulas.

O documento deve ser indicado por chaves ({...}).

Cada nome do campo no documento é um símbolo de íon que diferencia entre maiúsculas e minúsculas e pode ser indicado por aspas simples no PartiQL ('...').

Os valores de string também são denotados com aspas simples ('...') em PartiQL.

Qualquer literal de Ion pode ser indicado com acentos graves (`...`).

nota

Os colchetes angulares duplos (<<...>>) denotam uma coleção não ordenada (conhecida como bolsa no PartiQL) e são necessários somente se você quiser inserir vários documentos.

Valor de retorno

documentId: o ID exclusivo de cada documento que você inseriu.

Exemplos

Insira um único documento.

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidFromDate' : `2017-09-14T`, --Ion timestamp literal with day precision
    'ValidToDate' : `2020-06-25T`
}

Essa instrução retorna o ID exclusivo do documento que você inseriu, da seguinte forma.

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

Insira vários documentos.

INSERT INTO Person << 
{
    'FirstName' : 'Raul',
    'LastName' : 'Lewis',
    'DOB' : `1963-08-19T`,
    'GovId' : 'LEWISR261LL',
    'GovIdType' : 'Driver License',
    'Address' : '1719 University Street, Seattle, WA, 98109'
},
{
    'FirstName' : 'Brent',
    'LastName' : 'Logan',
    'DOB' : `1967-07-03T`,
    'GovId' : 'LOGANB486CG',
    'GovIdType' : 'Driver License',
    'Address' : '43 Stockert Hollow Road, Everett, WA, 98203'
},
{
    'FirstName' : 'Alexis',
    'LastName' : 'Pena',
    'DOB' : `1974-02-10T`,
    'GovId' : '744 849 301',
    'GovIdType' : 'SSN',
    'Address' : '4058 Melrose Street, Spokane Valley, WA, 99206'
}
>>

Essa instrução retorna o ID exclusivo de cada documento que você inseriu, da seguinte forma.

{
    documentId: "6WXzLscsJ3bDWW97Dy8nyp"
},
{
    documentId: "35e0ToZyTGJ7LGvcwrkX65"
},
{
    documentId: "BVHPcH612o7JROQ4yP8jiH"
}

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: