Controlador Amazon QLDB para Python

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

Temas

• Recursos de controladores
• Requisitos previos
• Instalación
• Tutorial de inicio rápido
• Referencia de libro de recetas

Recursos de controladores

Para obtener más información sobre las funcionalidades compatibles con el controlador Python, consulte los siguientes recursos:

• Referencia de API: 3.x, 2.x

• Código origen del controlador (GitHub)

• Ejemplo de código origen de aplicación (GitHub)

• Ejemplos de código de Amazon Ion

Requisitos previos

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

1. Siga las instrucciones de configuración de AWS en Acceso a Amazon QLDB. Estas incluyen las siguientes:

   1. Regístrese en AWS.

   2. Cree un usuario con los permisos de QLDB adecuados.

   3. Conceda acceso programático de desarrollo.

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

   • 3.6 o posterior: controlador de QLDB para Python v3

   • 3.4 o posterior: controlador de QLDB para Python v2

3. Configure sus credenciales AWS y sus Región de AWS predeterminadas. Para obtener instrucciones, consulte inicio rápido en la documentación AWS SDK for Python (Boto3).

   Para ver una lista completa de las regiones disponibles, consulte puntos de conexión y cuotas de Amazon QLDB en Referencia general de AWS.

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

• Para instalar el controlador QLDB y AWS SDK for Python (Boto3) en un proyecto existente, acceda a Instalación.

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

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

Instalación

QLDB es compatible con las siguientes versiones de controlador y sus dependencias de Python.

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

Para instalar el controlador QLDB desde PyPI con pip (un administrador de paquetes para Python), introduzca la siguiente línea de comando.

3.x

pip install pyqldb

2.x

pip install pyqldb==2.0.2

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

Uso del controlador para conectar a un libro mayor

A continuación, puede importar el controlador y usarlo para conectar a un libro mayor. En el siguiente ejemplo de código de Python se muestra cómo crear una sesión para un nombre de libro mayor específico.

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ódigos cortos sobre cómo ejecutar transacciones de datos básicos en un libro mayor, consulte la Referencia de libro de recetas.