Comando INSERT en Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)
SintaxisParámetrosValor devueltoEjemplosEjecución mediante programación mediante el controlador

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Comando INSERT en Amazon QLDB

En Amazon QLDB, utilice elINSERT comando para añadir uno o más documentos de Amazon Ion a una tabla.

nota

Para obtener información sobre cómo controlar el acceso para ejecutar este comando de PartiQL en tablas específicas, consulteIntroducción al modo de permisos estándar en Amazon QLDB.

Sintaxis

Inserte un documento.

INSERT INTO table_name VALUE document

Inserta varios documentos.

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

Parámetros

table_name

El nombre de la tabla de usuario en la que desea insertar los datos. La tabla debe existir previamente. Las sentencias DML solo se admiten en la vista de usuario predeterminada.

documento

Un documento QLDB válido. Debe especificar al menos un documento. Los documentos múltiples deben ir separados por comas.

El documento debe indicarse entre corchetes ({...}).

Cada nombre de campo del documento es un símbolo Ion que distingue mayúsculas de minúsculas y que se puede indicar con comillas simples ('...') en PartiQL.

Los valores string también se denotan con comillas simples ('...') en PartiQL.

Cualquier literal de iones se puede indicar con comillas invertidas (`...`).

nota

Los corchetes de doble ángulo (<<...>>) indican una colección desordenada (conocida como bolsa en PartiQL) y solo son necesarios si desea insertar varios documentos.

Valor devuelto

documentId— El identificador único de cada documento que ha insertado.

Ejemplos

Inserte un 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`
}

Esta instrucción devuelve el identificador único del documento que ha insertado, de la siguiente manera.

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

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

Esta instrucción devuelve el identificador único de cada documento que ha insertado, de la siguiente manera.

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

Ejecución mediante programación mediante el controlador

Para aprender a ejecutar esta sentencia mediante programación con el controlador QLDB, consulte los siguientes tutoriales en Introducción al controlador: