Acceder a Amazon QLDB mediante la consola

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.

Puede acceder al AWS Management Console para Amazon QLDB en https://console.aws.amazon.com/qldb.

Puede usar la consola para hacer lo siguiente en: QLDB

• Cree, elimine, describa y enumere los libros mayores.

• Ejecute instrucciones PartiQL mediante el editor de PartiQL.

• Administre las etiquetas de QLDB los recursos.

• Verifique criptográficamente los datos del diario.

• Exporte o transmita bloques de diario.

Para obtener información sobre cómo crear un QLDB registro de Amazon y configurarlo con ejemplos de datos de aplicación, consultePrimeros pasos con la QLDB consola Amazon.

Referencia rápida del editor de PartiQL

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.

Amazon QLDB admite un subconjunto de PartiQL como lenguaje de consulta y Amazon Ion como formato de datos orientado a documentos. Para obtener una guía completa e información más detallada sobre la QLDB implementación de PartiQL, consulte la. Referencia de Amazon QLDB PartiQL

Los siguientes temas proporcionan una descripción general de referencia rápida sobre cómo utilizar PartiQL en. QLDB

Consejos rápidos sobre PartiQL en QLDB

El siguiente es un breve resumen de los consejos y las mejores prácticas para trabajar con PartiQL en: QLDB

• Conozca los límites de simultaneidad y transacciones: todas las declaraciones, incluidas las SELECT consultas, están sujetas a un control optimista de la simultaneidad (OCC) de los conflictos y a los límites de transacción, incluido un tiempo de espera de transacción de 30 segundos.

• Utilice índices: utilice índices de cardinalidad alta y ejecute consultas dirigidas para optimizar sus instrucciones y evitar tener que escanear tablas completas. Para obtener más información, consulte Optimización del rendimiento de las consultas.

• Utilice predicados de igualdad: las búsquedas indexadas requieren un operador de igualdad (= o IN). Los operadores de desigualdad (<, >, LIKE, BETWEEN) no cumplen los requisitos para las búsquedas indexadas y dan como resultado escaneos de tablas completas.

• Utilice únicamente combinaciones internas: solo QLDB admite uniones internas. Como práctica recomendada, combine los campos que estén indexados para cada tabla que vaya a unir. Elija índices de cardinalidad alta tanto para los criterios de unión como para los predicados de igualdad.

Comandos

QLDBadmite los siguientes comandos PartiQL.

Lenguaje de definición de datos () DDL

Comando	Descripción
CREATE INDEX	Crea un índice para un campo de documento de nivel superior de una tabla.
CREATE TABLE	Crea una tabla.
DROP INDEX	Elimina un índice de una tabla.
DROP TABLE	Desactiva una tabla existente.
UNDROP TABLE	Reactiva una tabla inactiva.

Lenguaje de manipulación de datos (DML)

Comando	Descripción
DELETE	Marca un documento activo como eliminado mediante la creación de una nueva revisión final del documento.
FROM(INSERT,REMOVE, oSET)	Semánticamente igual que UPDATE.
INSERT	Añade uno o más documentos a una tabla.
SELECT	Recupera datos de una o más tablas.
UPDATE	Actualiza, inserta o elimina elementos específicos de un documento.

DMLejemplos de declaraciones

INSERT

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidToDate' : `2020-06-25T` --Ion timestamp literal with day precision
}

UPDATE-INSERT

UPDATE Vehicle AS v
INSERT INTO v VALUE 26500 AT 'Mileage'
WHERE v.VIN = '1N4AL11D75C109151'

UPDATE-REMOVE

UPDATE Person AS p
REMOVE p.Address
WHERE p.GovId = '111-22-3333'

SELECT— Subconsulta correlacionada

SELECT r.VIN, o.SecondaryOwners
FROM VehicleRegistration AS r, @r.Owners AS o
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT— Unión interna

SELECT v.Make, v.Model, r.Owners
FROM VehicleRegistration AS r INNER JOIN Vehicle AS v
ON r.VIN = v.VIN
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT— Obtenga la ID del documento mediante la cláusula BY

SELECT r_id FROM VehicleRegistration AS r BY r_id
WHERE r.VIN = '1HVBBAANXWH544237'

Vistas definidas por el sistema

QLDBadmite las siguientes vistas de una tabla definidas por el sistema.

Visualización	Descripción
table_name	La vista de usuario predeterminada de una tabla que incluye únicamente el estado actual de los datos de usuario.
_ql_committed_table_name	La vista confirmada completa definida por el sistema de una tabla que incluye el estado actual de los datos de usuario y los metadatos generados por el sistema, como el identificador de un documento.
history(table_name)	La función de historial integrada que devuelve el historial de revisiones completo de una tabla.

Reglas básicas de sintaxis

QLDBadmite las siguientes reglas sintácticas básicas para PartiQL.

Carácter	Descripción
'	Las comillas simples indican valores de cadena o nombres de campo en las estructuras de Amazon Ion.
"	Las comillas dobles indican identificadores entre comillas, como una palabra reservada que se usa como nombre de tabla.
`	Los acentos graves indican valores literales de Ion.
.	La notación de puntos permite acceder a los nombres de campo de una estructura principal.
[ ]	Los corchetes definen una list de Ion o indican un número ordinal basado en cero para una lista existente.
{ }	Los corchetes definen un struct de Ion.
<< >>	Los paréntesis angulares dobles definen una bag de PartiQL, que es una colección desordenada. Se utiliza una bag para insertar varios documentos en una tabla.
Sensibilidad de mayúsculas y minúsculas	Todos los nombres de los objetos QLDB del sistema, incluidos los nombres de los campos y los nombres de las tablas, distinguen mayúsculas de minúsculas.

Atajos de teclado del editor PartiQL

El editor PartiQL de la QLDB consola admite los siguientes atajos de teclado.

Acción	macOS	Windows
Ejecute	Cmd+Return	Ctrl+Enter
Comentario	Cmd+/	Ctrl+/
Clear	Cmd+Shift+Delete	Ctrl+Shift+Delete