QLDBControlador de Amazon para Python - Base de datos Amazon Quantum Ledger (AmazonQLDB)
Recursos de controladoresRequisitos previosInstalación

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.

QLDBControlador de Amazon para Python

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.

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

Temas

Recursos de controladores

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

Requisitos previos

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

  1. Siga las instrucciones de AWS configuración que se indican enAcceder a Amazon QLDB. Esta incluye lo siguiente:

    1. Inscríbase en AWS.

    2. Cree un usuario con los QLDB permisos 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: QLDB controlador para Python v3

    • 3.4 o posterior: QLDB controlador para Python v2

  3. Configura tus AWS credenciales y las predeterminadas Región de AWS. Para obtener instrucciones, consulte Inicio rápido en la AWS SDK for Python (Boto3) documentación.

    Para obtener una lista completa de las regiones disponibles, consulta los QLDBpuntos de conexión y las cuotas de Amazon 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 QLDB controlador y el AWS SDK for Python (Boto3) en un proyecto existente, proceda aInstalació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 API operaciones de datos y administración en la aplicación de ejemplo completa del tutorial, consulte laTutorial de Python.

Instalación

QLDBadmite las siguientes versiones de controladores y sus dependencias de Python.

Versión de controlador Versión de Python Status 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 QLDB controlador desde PyPI pip mediante (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 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 Referencia de libro de recetas.