Python 用 Amazon QLDB ドライバー - Amazon Quantum Ledger Database (Amazon QLDB)
ドライバーに関するリソース前提条件インストール

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Python 用 Amazon QLDB ドライバー

台帳内のデータを操作するには、AWS が提供するドライバーを使用して Python アプリケーションから Amazon QLDB に接続します。次のトピックでは、Python 用 QLDB ドライバーの使用を開始する方法について説明します。

トピック

ドライバーに関するリソース

Python ドライバーでサポートされている機能の詳細については、以下のリソースを参照してください。

前提条件

Python 用 QLDB ドライバーの使用を開始する前に、次のことを行う必要があります。

  1. 「Amazon QLDB へのアクセス」にある AWS の設定手順に従います。これには以下が含まれます。

    1. AWS にサインアップする。

    2. QLDB の適切なアクセス許可を持つユーザーを作成します。

    3. 開発に必要なプログラムへのアクセスを提供します。

  2. Python ダウンロードサイトから次のバージョンの Python のいずれかをインストールします。

    • 3.6 またはそれ以降 – Python v3 用の QLDB ドライバー

    • 3.4 またはそれ以降 – Python v2 用の QLDB ドライバー

  3. AWS の認証情報とデフォルトの AWS リージョン を設定します。手順については、AWS SDK for Python (Boto3) ドキュメントの「クイックスタート」を参照してください。

    利用可能なリージョンの完全なリストについては、「AWS 全般のリファレンス」の「Amazon QLDB エンドポイントとクォータ」を参照してください。

次に、すべてのチュートリアル用のサンプルアプリケーションをダウンロードするか、Python プロジェクトにのみドライバーをインストールして短いコード例を実行できます。

  • 既存のプロジェクトに QLDB ドライバーと AWS SDK for Python (Boto3) をインストールするには、「インストール」に進みます。

  • プロジェクトを設定し、台帳の基本的なデータトランザクションを示す短いコード例については、「クイックスタートチュートリアル」を参照してください。

  • チュートリアルのサンプルアプリケーション全体のデータプレーンと管理 API の両方のオペレーションを実行する詳細な例については、「Python チュートリアル」を参照してください。

インストール

QLDB は、以下のドライバーバージョンと Python の依存関係をサポートしています。

ドライバーのバージョン Python バージョン ステータス 最新リリース日
2.x 3.4 以降 本番リリース 2020 年 5 月 7 日
3.x 3.6 以降 本番リリース 2021 年 10 月 28 日

pip (Python のパッケージマネージャー) を使用して PyPI から QLDB ドライバーをインストールするには、コマンドラインで次のように入力します。

3.x
pip install pyqldb
2.x
pip install pyqldb==2.0.2

ドライバーをインストールすると、AWS SDK for Python (Boto3) や Amazon Ion パッケージなどの依存関係もインストールされます。

ドライバーを使用して台帳に接続する

その後、ドライバーをインポートし、それを使用して台帳に接続することができます。次の Python コード例は、指定した台帳名のセッションを作成する方法を示しています。

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)

台帳に対して基本的なデータトランザクションを実行する方法を示す短いコード例については、「クックブックリファレンス」を参照してください。