INSERT - Amazon Quantum Ledger Database (Amazon QLDB)

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.

INSERT

UsarINSERTpara añadir uno o más documentos de Amazon Ion a una tabla en Amazon QLDB.

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 usuarios en la que desea insertar los datos. La tabla debe existir previamente. Las instrucciones DML solo se admiten en la configuración predeterminadaVisualización de los usuarios.

documento

Una claveDocumento QLDB. Debe especificar al menos un documento. Los documentos múltiples deben estar separados por comas.

El documento debe indicarse con llaves ({...}).

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

Los valores de cadena también se indican mediantesolterocomillas ('...') en PartiQL.

Cualquier literal de Ion se puede indicar con acentos graves (`...`).

nota

Soportes angulares dobles (<<...>>) denotan una colección desordenada (conocida comobolsaen PartiQL) y solo son necesarias 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 ID ú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 insertó, de la siguiente manera.

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

Ejecución mediante programación mediante el controlador

Para obtener información sobre cómo ejecutar esta instrucción mediante programación mediante el controlador QLDB, consulte los siguientes tutoriales enIntroducción al conductor: