Crear tablas con índices e insertar documentos

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 registro de Amazon QLDB a Amazon Aurora PostgreSQL.

Tras crear un libro mayor de Amazon QLDB, el primer paso es crear una tabla con una instrucción CREATE TABLE básica. Las tablas se componen de Documentos de QLDB, que son conjuntos de datos en formato struct de Amazon Ion.

Creación de tablas e índices

Las tablas tienen nombres simples, que distinguen entre mayúsculas y minúsculas y que no tienen espacios de nombres. QLDB admite contenido abierto y no aplica el esquema, por lo que no se definen atributos o tipos de datos al crear tablas.

CREATE TABLE VehicleRegistration

CREATE TABLE Vehicle

Una instrucción CREATE TABLE devuelve el identificador asignado por el sistema a la nueva tabla. Todos los asignados por el sistema en IDs QLDB son identificadores únicos universales (UUID), cada uno de los cuales se representa en una cadena codificada en Base62.

nota

Si lo desea, puede definir etiquetas para un recurso de tabla mientras crea la tabla. Para aprender a hacerlo, consulte Etiquetado de tablas al crearlas.

También puede crear índices en tablas para optimizar el rendimiento de las consultas.

CREATE INDEX ON VehicleRegistration (VIN)

CREATE INDEX ON VehicleRegistration (LicensePlateNumber)

CREATE INDEX ON Vehicle (VIN)

importante

QLDB requiere un índice para buscar un documento de manera eficiente. Sin un índice, QLDB necesita escanear toda la tabla al leer los documentos. Esto puede provocar problemas de rendimiento en tablas grandes, como conflictos de concurrencia y tiempos de espera de las transacciones.

Para evitar el escaneado de tablas, debe ejecutar las instrucciones con una cláusula de predicado WHERE usando un operador de igualdad (= o IN) en un campo indexado o en un ID de documento. Para obtener más información, consulte Optimización del rendimiento de las consultas.

Tenga en cuenta las siguientes restricciones al crear índices:

• Solo se puede crear un índice en un único campo de nivel superior. No se admiten índices compuestos, anidados, únicos ni basados en funciones.

• Puede crear un índice en cualquier tipo de datos de Ion, incluidos list y struct. Sin embargo, solo puede realizar la búsqueda indexada igualando el valor total de Ion, independientemente del tipo de Ion. Por ejemplo, cuando se utiliza un tipo list como índice, no se puede realizar una búsqueda indexada por un elemento de la lista.

• El rendimiento de las consultas solo mejora cuando se utiliza un predicado de igualdad; por ejemplo, WHERE indexedField = 123 o WHERE indexedField IN (456, 789).

  QLDB no respeta las desigualdades en los predicados de consulta. Como resultado, no se implementan los escaneos filtrados por rango.

• Los nombres de los campos indexados distinguen entre mayúsculas y minúsculas y pueden tener 128 caracteres como máximo.

• La creación de índices en QLDB es asíncrona. La cantidad de tiempo que tarda en crearse un índice en una tabla que no está vacía varía según el tamaño de la tabla. Para obtener más información, consulte Administrar índices.

Inserción de documentos

A continuación, puede insertar documentos en las tablas. Los documentos de QLDB se almacenan en formato Amazon Ion. Las siguientes instrucciones INSERT de PartiQL incluyen un subconjunto de los datos de muestra de registro del vehículo utilizados en Introducción a la consola de Amazon QLDB.

INSERT INTO VehicleRegistration
<< {
    'VIN' : '1N4AL11D75C109151',
    'LicensePlateNumber' : 'LEWISR261LL',
    'State' : 'WA',
    'City' : 'Seattle',
    'PendingPenaltyTicketAmount' : 90.25,
    'ValidFromDate' : `2017-08-21T`,
    'ValidToDate' : `2020-05-11T`,
    'Owners' : {
        'PrimaryOwner' : { 'PersonId' : '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ { 'PersonId' : '5Ufgdlnj06gF5CWcOIu64s' } ]
    }
},
{
    'VIN' : 'KM8SRDHF6EU074761',
    'LicensePlateNumber' : 'CA762X',
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75,
    'ValidFromDate' : `2017-09-14T`,
    'ValidToDate' : `2020-06-25T`,
    'Owners' : {
        'PrimaryOwner' : { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' },
        'SecondaryOwners' : []
    }
} >>

INSERT INTO Vehicle
<< {
    'VIN' : '1N4AL11D75C109151',
    'Type' : 'Sedan',
    'Year' : 2011,
    'Make' : 'Audi',
    'Model' : 'A5',
    'Color' : 'Silver'
} ,
{
    'VIN' : 'KM8SRDHF6EU074761',
    'Type' : 'Sedan',
    'Year' : 2015,
    'Make' : 'Tesla',
    'Model' : 'Model S',
    'Color' : 'Blue'
} >>

Sintaxis y semántica de PartiQL

• Los nombres de los campos se escriben entre comillas simples ('...').

• Los valores de las cadenas también se escriben entre comillas simples ('...').

• Las marcas de tiempo se escriben entre acentos graves (`...`). Los acentos graves se pueden utilizar para indicar cualquier literal de Ion.

• Los enteros y los decimales son valores literales que no es necesario indicar.

Para obtener más información sobre la sintaxis y la semántica de PartiQL, consulte Consulta de Ion con PartiQL en Amazon QLDB.

Una instrucción INSERT crea la revisión inicial de un documento con un número de versión igual a cero. Para identificar de forma única cada documento, QLDB asigna un identificador de documento como parte de los metadatos. Las instrucciones de inserción devuelven el identificador de cada documento que se inserta.

importante

Como QLDB no aplica el esquema, puede insertar el mismo documento en una tabla varias veces. Cada instrucción de inserción incluye una entrada de documento independiente en el diario y QLDB asigna a cada documento un identificador único.

Para obtener información sobre cómo consultar los documentos que ha insertado en la tabla, continúe con Consulta de sus datos.