Comando INSERT 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à.

Comando INSERT in Amazon QLDB

In Amazon QLDB, usa ilINSERT 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, vedereGuida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

Sintassi

Inserire un singolo documento.

INSERT INTO table_name VALUE document

Inserisci 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. Le istruzioni DML sono supportate solo nella visualizzazione utente predefinita.

documento

Un documento QLDB valido. Devi specificare almeno un documento. Devi separare più documenti da virgole.

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

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

Anche i valori stringa sono riportati con virgolette singole ('...') in PartiQL.

Qualsiasi valore letterale Ion può essere indicato con contrassegni (`...`).

Nota

Le parentesi a doppio angolo (<<...>>) 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 che hai 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 imparare a eseguire questa istruzione a livello di codice utilizzando il driver QLDB, consulta i seguenti tutorial in Guida introduttiva al driver: