的亚马逊QLDB驱动程序。 NET

重要

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

要处理账本中的数据，你可以通过微软连接到亚马逊QLDB。 NET使用 AWS 提供的驱动程序进行应用程序。司机瞄准。 NET标准 2.0。更具体地说，它支持。 NET酷睿 (LTS) 2.1+ 和。 NET框架 4.5.2+。有关兼容性的信息，请参阅。 NET在 Microsoft 文档网站上标配。

我们强烈建议使用 Ion 对象映射器来完全无需在 Amazon Ion 类型和原生 C# 类型之间进行手动转换。

以下主题介绍如何开始使用的QLDB驱动程序。 NET。

主题

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

驱动程序资源

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

• API参考

• 驱动程序源代码 (GitHub)

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

• Amazon Ion 说明书

• 离子物体映射器 () GitHub

先决条件

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

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

   1. 报名参加 AWS.

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

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

2. 下载并安装。 NET来自微软的核心SDK版本 2.1 或更高版本。 NET下载网站。

3. （可选）安装你选择的集成开发环境 (IDE)，例如 Visual Studio、Mac 版 Visual Studio 或 Visual Studio Code。你可以从微软 Visual Studio 网站下载这些文件。

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

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

      有关说明，请参阅AWS SDK for .NET 开发者指南中的使用凭证文件配置 AWS 证书。

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

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

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

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

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

安装

使用 NuGet 软件包管理器为安装QLDB驱动程序。 NET。我们建议使用 Visual Studio 或您选择IDE的方法来添加项目依赖关系。驱动程序包名称为 Amazon。 QLDB.Driver。

例如，在 Visual Studio 中，在 “工具” 菜单上打开 Pack NuGet age Manager 控制台。然后在 PM> 提示符处，输入以下命令。

PM> Install-Package Amazon.QLDB.Driver

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

安装 Ion 对象映射器

的QLDB驱动程序版本 1.3.0。 NET引入了无需使用 Amazon Ion 即可接受和返回原生 C# 数据类型的支持。要使用此功能，请将以下软件包添加到您的项目中。

• 亚马逊。 QLDB.Driver.Ser ialization — 一个可以将 Ion 值映射到 C# 普通旧CLR对象 (POCO) 的库，反之亦然。此 Ion 对象映射器可让您的应用程序直接与原生 C# 数据类型进行交互，而无需使用 Ion。有关如何使用此库的简短指南，请参阅 GitHub 存储awslabs/amazon-qldb-driver-dotnet库中的 SERIALIZATION.md 文件。

要安装此程序包，请输入以下命令：

PM> Install-Package Amazon.QLDB.Driver.Serialization

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