INSERTcomando in Amazon QLDB - Database Amazon Quantum Ledger (Amazon) QLDB
SintassiParametriValore restituitoEsempiEsecuzione a livello di codice utilizzando il driver

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

INSERTcomando in Amazon QLDB

Importante

Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto il 31/07/2025. Per ulteriori dettagli, consulta Migrare un Amazon QLDB Ledger ad Amazon Aurora Postgre. SQL

In AmazonQLDB, usa il INSERT comando per aggiungere uno o più documenti Amazon Ion a una tabella.

Nota

Per informazioni su come controllare l'accesso per eseguire questo comando PartiQL su tabelle specifiche, vedere. Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB

Sintassi

Inserire un singolo documento.

INSERT INTO table_name VALUE document

Inserire più documenti.

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

Parametri

table_name

Il nome della tabella utente in cui si desidera inserire i dati. La tabella deve già essere presente. DMLle istruzioni sono supportate solo nella visualizzazione utente predefinita.

document

Un QLDBdocumento valido. È necessario specificare almeno un documento. Più documenti devono essere separati da virgole.

Il documento deve essere contrassegnato da parentesi graffe (). {...}

Ogni nome di campo nel documento è un simbolo Ion con distinzione tra maiuscole e minuscole che può essere indicato con virgolette singole () '...' in PartiQL.

I valori delle stringhe sono inoltre indicati da virgolette singole ('...') in PartiQL.

Qualsiasi valore letterale ionico può essere indicato con backticks (). `...`

Nota

Le parentesi angolari doppie (<<...>>) indicano una raccolta non ordinata (nota come borsa in PartiQL) e sono necessarie solo se si desidera inserire più documenti.

Valore restituito

documentId— L'ID univoco di ogni documento inserito.

Esempi

Inserire un singolo 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`
}

Questa istruzione restituisce l'ID univoco del documento inserito, come segue.

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

Inserisci più documenti.

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'
}
>>

Questa istruzione restituisce l'ID univoco di ogni documento inserito, come segue.

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

Esecuzione a livello di codice utilizzando il driver

Per informazioni su come eseguire questa istruzione a livello di codice utilizzando il QLDB driver, consulta i seguenti tutorial in Guida introduttiva al driver: