pilote Amazon QLDB pour Python - Amazon Quantum Ledger Database (Amazon QLDB)
Ressources pour les conducteursPrérequisInstallation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

pilote Amazon QLDB pour Python

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL.

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

Rubriques

Ressources pour les conducteurs

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

Prérequis

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

  1. Suivez les instructions AWS de configuration indiquées dansAccès à Amazon QLDB. Cela inclut les éléments suivants :

    1. Inscrivez-vous pour AWS.

    2. Créez un utilisateur doté des autorisations QLDB appropriées.

    3. Accordez un accès programmatique pour le développement.

  2. Installez l'une des versions suivantes de Python depuis le 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 vos AWS informations d'identification et celles par défaut Région AWS. Pour obtenir des instructions, consultez Quickstart dans la AWS SDK for Python (Boto3) documentation.

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

Ensuite, vous pouvez télécharger l'exemple complet du didacticiel, ou vous pouvez installer uniquement le pilote dans un projet Python et exécuter des exemples de code abrégé.

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

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

  • Pour obtenir des exemples plus détaillés des opérations relatives aux données et aux 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 en Python.

Versions du pilote Version Python Statut Date de sortie la plus récente
2. x 3.4 ou version ultérieure Communiqué de production 7 mai 2020
3. x 3.6 ou version ultérieure Communiqué de production 28 octobre 2021

Pour installer le pilote QLDB depuis PyPI à l'aide de pip (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 installe également ses dépendances, notamment les packages AWS SDK for Python (Boto3)et Amazon Ion.

Utiliser le 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 abrégé expliquant comment exécuter des transactions de données de base sur un registre, consultez leRéférence de livre de cuisine.