Go 版 Amazon QLDB 驱动程序

重要

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

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

主题

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

驱动程序资源

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

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

• 驱动程序源代码 (GitHub)

• Amazon Ion 说明书

先决条件

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

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

   1. 报名参加 AWS.

   2. 创建具有相应QLDB权限的用户。

   3. 授权以编程方式访问开发。

2. （可选）安装您选择的集成开发环境 (IDE)。有关常用于 Go IDEs 的列表，请参阅编辑器插件和 IDEs Go 网站。

3. 从 Go 下载网站下载并安装以下 Go 版本之一：

   • 1.15 或更高版本 — Go v3 的QLDB驱动程序

   • 1.14 — Go v1 或 v2 的QLDB驱动程序

4. 配置您的开发环境用于 AWS SDK for Go：

   1. 设置您的 AWS 凭证。我们建议创建共享的凭证文件。

      有关说明，请参阅AWS SDK for Go 开发者指南中的指定凭证。

   2. 设置您的默认 AWS 区域。要了解如何操作，请参阅指定 AWS 区域。

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

接下来，您可以设置基本的示例应用程序并运行简短的代码示例，也可以将驱动程序安装到现有的 Go 项目中。

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

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

安装

Go 的QLDB驱动程序在 GitHub 存储库 awslabs amazon-qldb-driver-go/中是开源的。QLDB支持以下驱动程序版本及其 Go 依赖关系。

驱动程序版本	Go 版本	Status	最新发布日期
1.x	1.14 或更高版本	量产版	2021 年 6 月 16 日
2.x	1.14 或更高版本	量产版	2021 年 7 月 21 日
3.x	1.15 或更高版本	量产版	2022 年 11 月 10 日

安装驱动程序

1. 确保您的项目使用 Go 模块来安装项目依赖项。

2. 在您的项目目录中输入以下 go get 命令。

   3.x

   $ go get -u github.com/awslabs/amazon-qldb-driver-go/v3/qldbdriver

   2.x

   $ go get -u github.com/awslabs/amazon-qldb-driver-go/v2/qldbdriver

安装驱动程序还会安装其依赖项，包括 AWS SDK for Go 或 AWS SDK for Go v2 和 Amazon Ion软件包。

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