Pilote Amazon QLDB pour Python

Pour utiliser les données de votre registre, vous pouvez vous connecter à Amazon QLDB depuis votre application Python à l'aide d'un piloteAWS fourni. Les rubriques suivantes décrivent comment démarrer avec le pilote QLDB pour Python.

Rubriques

• Ressources du conducteur
• Prérequis
• Installation
• Didacticiel de démarrage rapide
• Référence de livre de recettes

Ressources du conducteur

Pour plus d'informations sur les fonctionnalités prises en charge par le pilote Python, consultez les ressources suivantes :

• Référence de l'API : 3.x, 2.x

• Code source du pilote (GitHub)

• Exemple de code source d'application (GitHub)

• Exemples de code Amazon Ion

Prérequis

Avant de commencer à installer le pilote QLDB pour Python, vous devez effectuer les opérations suivantes :

1. Suivez les instructions deAWS configuration dansAccès à Amazon QLDB. Cela inclut les éléments suivants :

   1. S'inscrire àAWS.

   2. Créez un utilisateur avec les autorisations QLDB appropriées.

   3. Accorder un accès par programmation à des fins de développement.

2. Installez l'une des versions suivantes de Python à partir du site de téléchargement de Python :

   • 3.6 ou version ultérieure — pilote QLDB pour Python v3

   • 3.4 ou version ultérieure — pilote QLDB pour Python v2

3. Configurez vosAWS informations d'identification et celles par défautRégion AWS. Pour obtenir des instructions, voir Démarrage rapide dans laAWS SDK for Python (Boto3) documentation.

   Pour obtenir la liste complète des régions disponibles, consultez les points de terminaison et les quotas Amazon QLDB dans le Références générales AWS.

Vous pouvez ensuite télécharger l'exemple d'application complet du didacticiel, ou vous pouvez uniquement installer le pilote dans un projet Python et exécuter des exemples de code courts.

• Pour installer le pilote QLDB et leAWS SDK for Python (Boto3) dans un projet existant, passez àInstallation.

• Pour configurer un projet et exécuter des exemples de code abrégé illustrant les transactions de données de base sur un registre, consultez leDidacticiel de démarrage rapide.

• Pour exécuter des exemples plus détaillés d'opérations sur les données et les API de gestion dans l'exemple d'application complet du didacticiel, consultez leTutoriel Python.

Installation

QLDB prend en charge les versions de pilotes suivantes et leurs dépendances Python.

Versions du pilote	Version Python	État	Dernière date de parution
2.x	3.4 ou version ultérieure	Version de production	7 mai 2020
3.x	3.6 ou version ultérieure	Version de production	28 octobre 2021

Pour installer le pilote QLDB à partir de PyPI à l'aide depip (un gestionnaire de packages pour Python), entrez ce qui suit sur la ligne de commande.

3.x

pip install pyqldb

2.x

pip install pyqldb==2.0.2

L'installation du pilote entraîne également l'installation de ses dépendances, notamment les packages Amazon Ion AWS SDK for Python (Boto3)et Amazon.

Utilisation du pilote pour se connecter à un registre

Vous pouvez ensuite importer le pilote et l'utiliser pour vous connecter à un registre. L'exemple de code Python suivant montre comment créer une session pour un nom de registre spécifié.

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)

Pour des exemples de code courts expliquant comment exécuter des transactions de données de base sur un registre, consultez leRéférence de livre de recettes.