Conceptos básicos y terminología de Amazon QLDB

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.

En esta sección se ofrece una visión general de los conceptos y la terminología principales de AmazonQLDB, incluida la estructura del libro mayor y la forma en que un libro mayor gestiona los datos. Como base de datos contable, QLDB se diferencia de otras bases de datos orientadas a documentos en lo que respecta a los siguientes conceptos clave.

QLDBmodelo de objetos de datos

El modelo de objetos de datos fundamentales de Amazon QLDB se describe de la siguiente manera:

1. Libro mayor

   El primer paso es crear un libro mayor, que es el tipo de AWS recurso principal enQLDB. Para aprender a crear un libro mayor, consulte Paso 1: crear un nuevo libro mayor en Introducción a la consola o Operaciones básicas para los libros de QLDB contabilidad de Amazon.

   Tanto para el ALLOW_ALL modo de registro como para el de STANDARD permisos, se crean AWS Identity and Access Management (IAM) políticas que conceden permisos para ejecutar API operaciones en este recurso contable.

   Formato de libro mayorARN:

   arn:aws:qldb:${region}:${account-id}:ledger/${ledger-name}

2. Secuencia y tablas

   Para empezar a escribir datos en un QLDB libro mayor, primero debe crear una tabla con una declaración básicaCREATE TABLE. Los datos del libro mayor son revisiones de documentos consignados en el diario del libro mayor. Las revisiones de los documentos se consignan en el libro mayor en el contexto de tablas definidas por el usuario. EnQLDB, una tabla representa una vista materializada de un conjunto de revisiones de documentos del diario.

   En el modo de STANDARD permisos de un libro mayor, debes crear IAM políticas que concedan permisos para ejecutar sentencias PartiQL en este recurso de tabla. Con los permisos del recurso de tabla podrá ejecutar instrucciones para acceder al estado actual de la tabla. También puede consultar el historial de revisiones de la tabla usando la función integrada history().

   Formato de tablaARN:

   arn:aws:qldb:${region}:${account-id}:ledger/${ledger-name}/table/${table-id}

   Para obtener más información sobre cómo conceder permisos en un libro mayor y sus recursos asociados, consulte Cómo QLDB trabaja Amazon con IAM.

3. Documentos

   Las tablas se componen de revisiones de QLDBdocumentos, que son conjuntos de datos en formato struct de Amazon Ion. La revisión de un documento representa una versión única de un diario de documentos identificados mediante una ID de documento único.

   QLDBalmacena el historial de cambios completo de sus documentos confirmados. La tabla le permite consultar el estado actual de sus documentos, mientras que la función history() le permite consultar todo el historial de revisiones de los documentos de una tabla. Para obtener más información sobre la consulta y la escritura de revisiones, consulte Uso de datos e historial.

4. Catálogo de sistema

   Cada libro mayor también proporciona un recurso de catálogo definido por el sistema que puede consultar para obtener una lista de todas las tablas e índices de un libro mayor. En el modo de permisos STANDARD de un libro mayor, necesita el permiso qldb:PartiQLSelect de este recurso de catálogo para hacer lo siguiente:

   • Ejecutar instrucciones SELECT en la tabla del catálogo del sistema information_schema.user_tables.

   • Consulte la información de la tabla y el índice en la página de detalles del libro mayor de la QLDBconsola.

   • Consulta la lista de tablas e índices en el editor PartiQL de la QLDB consola.

   Formato de catálogoARN:

   arn:aws:qldb:${region}:${account-id}:ledger/${ledger-name}/information_schema/user_tables

Transacciones de diario primero

Cuando una aplicación lee o escribe datos en un QLDB libro mayor, lo hace en una transacción de base de datos. Todas las transacciones están sujetas a los límites definidos en Cuotas y límites en Amazon QLDB. Dentro de una transacción, QLDB realiza los siguientes pasos:

1. Lee el estado actual de los datos del libro mayor.

2. Realice las declaraciones incluidas en la transacción y, a continuación, compruebe si hay conflictos mediante el control de concurrencia optimista (OCC) para garantizar un aislamiento totalmente serializable.

3. Si no se encuentra ningún OCC conflicto, devuelva los resultados de la transacción de la siguiente manera:

   • En el caso de las lecturas, devuelve el conjunto de resultados y consigna las instrucciones SELECT en el diario únicamente como anexos.

   • En el caso de las escrituras, confirma en el diario todas las actualizaciones, eliminaciones o datos recién insertados únicamente como anexos.

El libro mayor contiene un historial completo e inmutable de todos los cambios en los datos. QLDBescribe un bloque encadenado en el diario de una transacción. Cada bloque contiene objetos de entrada que representan las revisiones del documento que inserta, actualiza y elimina, junto con las instrucciones PartiQL que confirmaron dichas acciones.

El siguiente diagrama ilustra la estructura de este diario.

El diagrama muestra que las transacciones se registran en el diario como bloques que contienen entradas de revisión de documentos. Cada bloque está codificado y encadenado a los siguientes bloques para su verificación. Cada bloque tiene un número de diario que especifica su dirección dentro de la cadena.

nota

En AmazonQLDB, un capítulo es una partición del diario de tu libro de contabilidad. QLDBactualmente solo admite diarios con una sola cadena.

Para obtener información sobre el contenido de los datos en un bloque, consulte Contenido de revistas en Amazon QLDB.

Consulta de sus datos

QLDBestá destinado a abordar las necesidades de las cargas de trabajo de procesamiento de transacciones en línea (OLTP) de alto rendimiento. El libro mayor proporciona vistas en tabla consultables de sus datos en función de la información de transacciones consignada en el diario. Una vista de tabla en QLDB es un subconjunto de los datos de una tabla. Las vistas se mantienen en tiempo real, por lo que siempre están disponibles para que las aplicaciones puedan consultarlas.

Puede consultar las siguientes vistas definidas por el sistema usando instrucciones SELECT de PartiQL:

• Usuario: la última revisión activa solo de los datos escritos en la tabla (es decir, el estado actual de los datos de usuario). Esta es la vista predeterminada enQLDB.

• Confirmada: la última revisión activa de sus datos de usuario y de los metadatos generados por el sistema. Esta es la tabla completa definida por el sistema que corresponde directamente a su tabla de usuario.

Además de estas vistas consultables, puede consultar el historial de revisiones de sus datos usando la función integrada Función de historial. La función de historial devuelve los datos de usuario y los metadatos asociados en el mismo esquema que la vista confirmada.

Almacenamiento de datos

Hay dos tipos de almacenamiento de datos enQLDB:

• Almacenamiento de secuencias: el espacio en disco que ocupa el diario de un libro mayor. El diario es un anexo que contiene el historial completo, inmutable y verificable de todos los cambios realizados en los datos.

• Almacenamiento indexado: el espacio en disco que ocupan las tablas, índices e historial indexado de un libro mayor. El almacenamiento indexado consiste en datos de libro mayor optimizados para consultas de alto rendimiento.

Una vez confirmados los datos en el diario, se materializan en las tablas que ha definido. Estas tablas están optimizadas para poder realizar consultas más rápidas y eficaces. Cuando una aplicación utiliza los datos transaccionales API para leer datos, accede a las tablas e índices que están almacenados en el almacenamiento indexado.

QLDBAPImodelo

QLDBproporciona dos tipos con los APIs que el código de la aplicación puede interactuar:

• Amazon QLDB: la gestión de QLDB recursos API (también conocida como plano de control). APISe usa solo para administrar los recursos del libro mayor y para las operaciones de datos no transaccionales. Puede usar estas operaciones para crear, eliminar, describir, enumerar y actualizar libros mayores. También puede verificar los datos criptográficamente y exportar o transmitir bloques de diarios.

• Amazon QLDB Session: los datos QLDB API transaccionales. Puede usarlo API para ejecutar transacciones de datos en un libro mayor con declaraciones PartiQL.

  importante

  En lugar de interactuar directamente con la QLDBsesiónAPI, se recomienda utilizar el QLDB controlador o el QLDB shell para ejecutar las transacciones de datos en un libro mayor.

  • Si está trabajando con un AWS SDK, utilice el QLDB controlador. El controlador proporciona una capa de abstracción de alto nivel sobre los datos de la QLDBsesión API y gestiona la SendCommand operación por usted. Para obtener más información y ver una lista de los lenguajes de programación compatibles, consulte Introducción al controlador.

  • Si estás trabajando con AWS CLI, usa el QLDB shell. El shell es una interfaz de línea de comandos que utiliza el QLDB controlador para interactuar con un libro mayor. Para obtener más información, consulte Uso del QLDB shell de Amazon (APIsolo datos).

Para obtener más información sobre estas API operaciones, consulte. QLDBAPIReferencia de Amazon

Siguientes pasos

Para aprender a usar un libro mayor con sus datos, consulte Trabajar con datos e historial en Amazon QLDB y siga los ejemplos que describen el proceso de creación de tablas, inserción de datos y ejecución de consultas básicas. Esta guía explica en detalle el funcionamiento de estos conceptos con ejemplos de consultas y datos de muestra para ofrecer un mayor contexto.

Para empezar rápidamente con un ejemplo de tutorial de aplicación que utiliza la QLDB consola, consultePrimeros pasos con la QLDB consola de Amazon.

Para consultar una lista de los términos y definiciones clave descritos en esta sección, acceda a QLDBGlosario de Amazon.