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 の適切なアクセス許可を持つ AWS Identity and Access Management (IAM) ユーザーを作成します。

    3. 開発用の IAM アクセスキーを取得します。

  2. Python ダウンロードサイトから Python バージョン 3.4 以降をインストールします。

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

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

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

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

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

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

インストール

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

ドライバーのバージョン Python バージョン [Status] (ステータス) 最新リリース日
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)

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