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

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

适用于 .NET 的 Amazon QLDB 驱动程序

重要

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

要处理账本中的数据，您可以使用提供的驱动程序从 Microsoft .NET 应用程序连接到 Amazon QLDB。 AWS 分类账定位于 .NET 标准 2.0。更具体地说，它支持 .NET Core（LTS）2.1+ 和 .NE T Framework 4.5.2+。有关兼容性的信息，请参阅 Microsoft 文档网站上的 .NET 标准。

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

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

主题

驱动程序资源

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

先决条件

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

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

    1. 报名参加 AWS.

    2. 创建具有适当 QLDB 权限的用户。

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

  2. 从微软 .NET 下载网站下载并安装 .NET Core SDK 2.1 或更高版本。

  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 区域 选择。

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

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

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

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

安装

使用 NuGet 包管理器安装适用于.NET 的 QLDB 驱动程序。我们建议使用 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 对象映射器

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

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

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

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

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