Crear tablas con índices e insertar documentos

importante

Aviso de fin de soporte: los clientes actuales podrán usar 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.

Tras crear un QLDB libro mayor de Amazon, el primer paso es crear una tabla con una CREATE TABLE declaración básica. Las tablas se componen de QLDBdocumentos, 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. QLDBadmite contenido abierto y no aplica el esquema, por lo que no se definen atributos ni 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 identificadores universales asignados por IDs el sistema QLDB son identificadores únicos (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 saber cómo 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

QLDBrequiere un índice para buscar un documento de manera eficiente. Sin un índice, QLDB necesita escanear una tabla completa 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).

  QLDBno respeta las desigualdades en los predicados de las consultas. 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 del índice 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. QLDBlos documentos 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 Primeros pasos con la QLDB consola de Amazon.

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 Consultando 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 impone el esquema, puede insertar el mismo documento en una tabla varias veces. Cada sentencia de inserción registra 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.