Comando INSERT en Amazon QLDB - 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.

Comando INSERT en Amazon QLDB

En Amazon QLDB, utilice el comando INSERT 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 PartiQL en tablas específicas, consulte Introducción al modo de permisos estándar en Amazon QLDB.

Sintaxis

Insertar un documento.

INSERT INTO table_name VALUE document

Insertar varios documentos.

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

Parámetros

table_name

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

documento

Un documento QLDB válido. Debe especificar al menos un documento. Los múltiples documentos deben ir 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 que se puede indicar con comillas simples ('...') en PartiQL.

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

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

nota

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

Valor devuelto

documentId: el identificador único de cada documento que ha insertado.

Ejemplos

Insertar 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" }

Insertar 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 con el controlador

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