适用于 Python 的亚马逊QLDB驱动程序

重要

终止支持通知：现有客户可以在2025年7月31日终止支持QLDB之前使用亚马逊。有关更多详细信息，请参阅将亚马逊QLDB账本迁移到亚马逊 Aurora Postgr SQL e。

要处理账本中的数据，您可以使用 AWS 提供的驱动程序QLDB从 Python 应用程序连接到 Amazon。以下主题介绍如何开始使用 Python QLDB 驱动程序。

主题

• 驱动程序资源
• 先决条件
• 安装
• 快速入门教程
• 说明书参考

驱动程序资源

有关 Python 驱动程序支持功能的更多信息，请参阅以下资源：

• API参考：3.x、2.x

• 驱动程序源代码 (GitHub)

• 示例应用程序源代码 (GitHub)

• Amazon Ion 代码示例

先决条件

在开始使用 Python QLDB 驱动程序之前，必须执行以下操作：

1. 按照中的 AWS 设置说明进行操作访问亚马逊 QLDB。这包括以下这些：

   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) 文档中的快速入门。

   有关可用区域的完整列表，请参阅中的 Amazon QLDB 终端节点和配额AWS 一般参考。

接下来，您可下载完整的教程示例应用程序，也可以只在 Python 项目中安装驱动程序并运行短代码示例。

• 要 AWS SDK for Python (Boto3) 在现有项目中安装QLDB驱动程序和，请继续安装。

• 要设置项目并运行演示分类账上基本数据事务的简短代码示例，请参阅 快速入门教程。

• 要在完整的教程示例应用程序中运行更深入的数据和管理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)

有关如何在分类账上运行基本数据事务的简短代码示例，请参阅 说明书参考。