适用于 Go 的 Amazon QLDB 驱动程序 - Amazon Quantum Ledger Database (Amazon QLDB)
驱动程序资源先决条件安装

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

适用于 Go 的 Amazon QLDB 驱动程序

重要

终止支持通知：现有客户将能够使用 Amazon QLDB，直到 2025 年 7 月 31 日终止支持。有关更多详细信息，请参阅将亚马逊 QLDB 账本迁移到亚马逊 Aurora PostgreSQL。

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

主题

驱动程序资源

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

先决条件

开始使用适用于 Go 的 QLDB 驱动程序之前，您必须执行以下操作:

  1. 按照中的 AWS 设置说明进行操作访问 Amazon 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 区域。

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

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

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

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

安装

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

驱动程序版本 Go 版本 状态 最新发布日期
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软件包。

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