QLDBDriver Amazon para Python

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

Para trabalhar com dados em seu livro contábil, você pode se conectar à Amazon a QLDB partir do seu aplicativo Python usando AWS um driver fornecido. Os tópicos a seguir descrevem como começar a usar o QLDB driver para Python.

Tópicos

• Recursos para driver
• Pré-requisitos
• Instalação
• Tutorial de início rápido
• Referência de Cookbook

Recursos para driver

Para obter mais informações sobre a funcionalidade suportada pelo driver Python, consulte os recursos a seguir:

• APIreferência: 3.x, 2.x

• Código-fonte do driver (GitHub)

• Exemplo de código-fonte do aplicativo (GitHub)

• Exemplos de código do Amazon Ion

Pré-requisitos

Antes de começar a usar o QLDB driver para Python, você deve fazer o seguinte:

1. Siga as instruções AWS de configuração emAcessando a Amazon QLDB. Essa transmissão inclui o seguinte:

   1. Inscreva-se em AWS.

   2. Crie um usuário com as QLDB permissões apropriadas.

   3. Conceda acesso programático para desenvolvimento.

2. Instale uma das seguintes versões do Python no site de downloads do Python:

   • 3.6 ou posterior — QLDB driver para Python v3

   • 3.4 ou posterior — QLDB driver para Python v2

3. Configure suas AWS credenciais e seu padrão Região da AWS. Para obter instruções, consulte Início rápido na AWS SDK for Python (Boto3) documentação.

   Para obter uma lista completa das regiões disponíveis, consulte QLDBendpoints e cotas da Amazon no. Referência geral da AWS

Em seguida, você pode baixar o aplicativo completo de amostra do tutorial ou instalar somente o driver em um projeto Python e executar exemplos de códigos curtos.

• Para instalar o QLDB driver e o AWS SDK for Python (Boto3) em um projeto existente, vá paraInstalação.

• Para configurar um projeto e executar exemplos de códigos curtos que demonstram transações básicas de dados em um ledger, consulte o Tutorial de início rápido.

• Para executar exemplos mais detalhados de API operações de dados e gerenciamento no aplicativo de amostra completo do tutorial, consulte o. Tutorial do Python

Instalação

QLDBsuporta as seguintes versões do driver e suas dependências do Python.

Versão do driver	Versão do Python	Status	Data da versão mais recente
2.x	3.4 ou posterior	Lançamento de produção	7 de maio de 2020
3.x	3.6 ou posterior	Lançamento de produção	28 de outubro de 2021

Para instalar o QLDB driver do PyPI pip usando (um gerenciador de pacotes para Python), digite o seguinte na linha de comando.

3.x

pip install pyqldb

2.x

pip install pyqldb==2.0.2

A instalação do driver também instala suas dependências, incluindo os pacotes AWS SDK for Python (Boto3) e Amazon Ion.

Como usar o driver para se conectar a um ledger

Depois, você pode importar o driver e usá-lo para se conectar a um ledger. Os exemplos de código Python a seguir mostram como criar uma sessão para um nome de livro contábil 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 exemplos de código curto de como executar transações básicas de dados em um ledger, consulte o Referência de Cookbook.