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.
INSERTcomando en Amazon QLDB
importante
Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre
En AmazonQLDB, utilice el INSERT
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 PartiQL en tablas específicas, consulte Cómo empezar con el modo de permisos estándar en Amazon QLDB.
Sintaxis
Insertar un documento.
INSERT INTO
table_name
VALUEdocument
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. DMLlas declaraciones solo se admiten en la vista de usuario predeterminada.
document
-
Un QLDBdocumento 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 sentencia mediante programación mediante el QLDB controlador, consulte los siguientes tutoriales en Introducción al controlador:
-
Java: Tutorial de inicio rápido | Referencia de libro de recetas
-
.NET: Tutorial de inicio rápido | Referencia de libro de recetas
-
Go: Tutorial de inicio rápido | Referencia de libro de recetas
-
Node.js: Tutorial de inicio rápido | Referencia de libro de recetas
-
Python: Tutorial de inicio rápido | Referencia de libro de recetas