Controlador Amazon QLDB para Python - Amazon Quantum Ledger Database (Amazon QLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Controlador Amazon QLDB para Python

Para trabajar con los datos de su libro mayor, puede conectarse a Amazon QLDB desde su aplicación de Python mediante un controladorAWS proporcionado. En los temas siguientes, se describe cómo empezar a utilizar el controlador QLDB para Python.

Recursos para conductores

Para obtener más información acerca de la funcionalidad que admite el controlador Python, vea los siguientes recursos:

Requisitos previos

Antes de empezar con el controlador QLDB para Python, debe hacer lo siguiente:

  1. Siga las instruccionesAWS de configuración que aparecen enAcceso a Amazon QLDB. Estas incluyen las siguientes:

    1. RegistrarseAWS en

    2. Cree un usuarioAWS Identity and Access Management (IAM) con los permisos de QLDB adecuados.

    3. Obtenga una clave de acceso IAM para el desarrollo

  2. Instale una de las siguientes versiones de Python desde el sitio de descargas de Python:

    • 3.6 o posterior: controlador QLDB para Python v3

    • 3.4 o posterior: controlador QLDB para Python v2

  3. Configura tusAWS credenciales y las predeterminadasRegión de AWS. Para obtener instrucciones, consulte la Guía de inicio rápido en laAWS SDK for Python (Boto3) documentación.

    Para obtener una lista completa de las regiones disponibles, consulte los puntos de enlace y las cuotas de Amazon QLDB en la ReferenciaAWS general.

A continuación, puede descargar la aplicación de ejemplo completa del tutorial o puede instalar solo el controlador en un proyecto de Python y ejecutar ejemplos de código cortos.

  • Para instalar el controlador QLDB y elAWS SDK for Python (Boto3) en un proyecto existente, vaya aInstalación.

  • Para configurar un proyecto y ejecutar ejemplos de código cortos que demuestren las transacciones de datos básicas en un libro mayor, consulte laTutorial de inicio rápido.

  • Para ejecutar ejemplos más detallados de las operaciones de la API de datos y administración en la aplicación de ejemplo del tutorial completo, consulte laTutorial de Python.

Instalación

QLDB admite las siguientes versiones de controladores y sus dependencias de Python.

Versión de controlador Versión de Python Estado Fecha de versiones más recientes
2.x 3.4 o posterior Lanzamiento de versiones 7 de mayo de 2020
3.x 3.6 o posterior Lanzamiento de versiones 28 de octubre de 2021

Para instalar el controlador QLDB desde PyPI utilizandopip (un administrador de paquetes para Python), introduzca lo siguiente en la línea de comandos.

3.x
pip install pyqldb
2.x
pip install pyqldb==2.0.2

Al instalar el controlador también se instalan sus dependencias, incluidos los paquetes Amazon Ion AWS SDK for Python (Boto3)y Amazon Ion.

Uso del controlador para conectarse a un libro mayor

A continuación, puede importar el controlador y usarlo para conectarse a un libro mayor. En los ejemplos de código Python siguientes, se muestra cómo crear una sesión para un nombre de libro mayor especificado.

3.x
from pyqldb.driver.qldb_driver import QldbDriver qldb_driver = QldbDriver(ledger_name='testLedger') for table in qldb_driver.list_tables(): print(table)
2.x
from pyqldb.driver.pooled_qldb_driver import PooledQldbDriver qldb_driver = PooledQldbDriver(ledger_name='testLedger') qldb_session = qldb_driver.get_session() for table in qldb_session.list_tables(): print(table)

Para ver ejemplos de código cortos sobre cómo ejecutar transacciones de datos básicos en un libro mayor, consulte laReferencia de los libros de recetas.