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 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. 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