Amazon QLDB-Treiber für Python

Um mit Daten in Ihrem Ledger zu arbeiten, können Sie von Ihrer Python-Anwendung aus mithilfe einesAWS bereitgestellten Treibers eine Verbindung zu Amazon QLDB herstellen. In den folgenden Themen wird die ersten Schritte durchführen: den QLDB-Treiber für Python tun.

Themen

• Ressourcen für Fahrer
• Voraussetzungen
• Installation
• Erste Schritte
• Kochbuchreferenz

Ressourcen für Fahrer

Weitere Informationen zu den vom Python-Treiber unterstützten Funktionen finden Sie in den folgenden Ressourcen:

• API-Referenz: 3.x, 2.x

• Treiber-Quellcode (GitHub)

• Quellcode der Beispielanwendung (GitHub)

• Beispiele für Amazon Ion-Code

Voraussetzungen

Bevor Sie mit dem QLDB-Treiber für Python beginnen, müssen Sie die folgenden Schritte durchführen:

1. Befolgen Sie die AWS-Einrichtungsanweisungen unter Zugreifen auf Amazon QLDB. Diese umfasst die folgenden Funktionen:

   1. Registrieren Sie sich beiAWS.

   2. Erstellen Sie einen Benutzer mit den entsprechenden QLDB-Berechtigungen.

   3. Erteilen programmgesteuerten Zugriffs für die Entwicklung

2. Installieren Sie eine der folgenden Versionen von Python von der Python-Downloadseite:

   • 3.6 oder später — QLDB-Treiber für Python v3

   • 3.4 oder später — QLDB-Treiber für Python v2

3. Richten Sie IhreAWS Anmeldeinformationen und Ihre Standardeinstellungen einAWS-Region. Weitere Informationen finden Sie unter Schnellstart in der AWS SDK for Python (Boto3)-Dokumentation.

   Eine vollständige Liste der verfügbaren Regionen finden Sie unter Amazon QLDB-Endpunkte und Kontingente in der Allgemeine AWS-Referenz.

Als Nächstes können Sie die vollständige Beispielanwendung für das Tutorial herunterladen — oder Sie können nur den Treiber in einem Python-Projekt installieren und kurze Codebeispiele ausführen.

• Um den QLDB-Treiber und denAWS SDK for Python (Boto3) in einem vorhandenen Projekt zu installieren, fahren Sie mit fortInstallation.

• Informationen zum Einrichten eines Projekts und zur Ausführung von kurzen Codebeispielen, die grundlegende Datentransaktionen in einem Ledger veranschaulichen, finden Sie unterErste Schritte.

• Ausführlichere Beispiele für Daten- und Verwaltungs-API-Operationen finden Sie in der vollständigen Beispielanwendung des Tutorials unterPython-Tutorial.

Installation

QLDB unterstützt die folgenden Treiberversionen und ihre Python-Abhängigkeiten.

Treiberversion	Python-Version	Status	Datum der letzten Veröffentlichung
2.x	3.4 oder später	Produktionsfreigabe	7. Mai 2020
3.x	3.6 oder höher	Produktionsfreigabe	28. Oktober 2021

Um den QLDB-Treiber von PyPI aus mitpip (einem Paketmanager für Python) zu installieren, geben Sie in der Befehlszeile Folgendes ein.

3.x

pip install pyqldb

2.x

pip install pyqldb==2.0.2

Durch die Installation des Treibers werden auch seine Abhängigkeiten installiert, einschließlich der Pakete AWS SDK for Python (Boto3)und Amazon Ion.

Verwenden des Treibers zum Herstellen einer Verbindung mit einem Ledger

Dann können Sie den Treiber importieren und mit ihm eine Verbindung zu einem Ledger herstellen. Im folgenden Python-Codebeispiel wird gezeigt, wie eine Sitzung für einen angegebenen Ledger-Namen erstellt wird.

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)

Kurze Codebeispiele für die Ausführung grundlegender Datentransaktionen in einem Ledger finden Sie unterKochbuchreferenz.