亞馬遜 QLDB 驅動程序的 Python

若要使用分類帳中的資料，您可以使用AWS提供的驅動程式，從 Python 應用程式連線到 Amazon QLDB。下列主題說明如何開始使用適用於 Python 的 QLDB 驅動程式。

主題

• 駕駛員資源
• 先決條件
• 安裝
• 速入門教學課程
• 食譜參考

駕駛員資源

如需 Python 驅動程式所支援功能的詳細資訊，請參閱下列資源：

• API 參考資料：3.x、2.x

• 驅動程式原始程式碼 (GitHub)

• 應用程式原始程式碼範例 (GitHub)

• Amazon Ion 程式碼範例

先決條件

您必須執行以下作：

1. 請遵循中的AWS設定指示訪問 Amazon QLDB。這包含下列項目：

   1. 註冊 AWS。

   2. 建立具有適當 QLDB 許可的使用者。

   3. 授予程式設計存取權，以供開發。

2. 從 Python 下載網站安裝下列其中一個版本：

   • 3.6 或更高版本-適用於蟒蛇 V3 的 QLDB 驅動程序

   • 3.4 或更新版本 — 適用於 Python V2 的 QLDB 驅動程式

3. 設定您的AWS憑證和預設值AWS 區域。如需指示，請參閱AWS SDK for Python (Boto3)文件中的快速入門。

   如需可用區域的完整清單，請參閱中的 Amazon QLDB 端點和配額AWS 一般參考。

接下來，您可以下載完整的教學課程範例應用程式，或者您可以只在 Python 專案中安裝驅動程式並執行簡短的程式碼範例。

• 若要AWS SDK for Python (Boto3)在現有專案中安裝 QLDB 驅動程式和，請繼續執行安裝。

• 若要設定專案並執行展示分類帳基本資料交易的簡短程式碼範例，請參閱速入門教學課程。

• 若要在完整的教學課程範例應用程式中執行資料和管理 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)

如需如何在分類帳上執行基本資料交易的簡短程式碼範例，請參閱食譜參考。