Amazon QLDB 驅動程序. NET - Amazon Quantum Ledger 資料庫 （Amazon QLDB）
司機資源必要條件安裝

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon QLDB 驅動程序. NET

重要

支援結束通知：現有客戶將能夠使用 Amazon，QLDB直到 2025 年 7 月 31 日終止支援為止。有關更多詳細信息，請參閱將 Amazon QLDB 分類帳遷移到 Amazon Aurora 郵政. SQL

要使用分類帳中的數據，您可以QLDB從 Microsoft 連接到 Amazon。 NET使用 AWS 提供的驅動程序應用程序。驅動程序的目標。 NET標準配備 更具體地說，它支持。 NET核心（LTS）2.1 + 和。 NET。框架 4.5.2 以上。如需相容性的資訊，請參閱。 NETMicrosoft 文檔網站上的標準。

我們強烈建議您使用 Ion 物件對應程式，完全避免在 Amazon Ion 類型和原生 C# 類型之間手動轉換的需求。

下列主題說明如何開始使用的QLDB驅動程式。 NET。

主題

司機資源

如需有關支援的功能的詳細資訊。 NET驅動程式，請參閱下列資源：

必要條件

在您開始使用的QLDB驅動程序之前。 NET，您必須執行下列動作：

  1. 按照中的 AWS 設定指示進行操作訪問 Amazon QLDB。這包含下列項目：

    1. 註冊 AWS.

    2. 建立具有適當QLDB權限的使用者。

    3. 授予程序化訪問以進行開發。

  2. 下載並安裝. NET核心SDK版本 2.1 或更高版本從 Microsoft。 NET下載網站。

  3. (選擇性) 安裝您選擇的整合式開發環境 (IDE)，例如視覺工作室、Mac 版或視覺工作室程式碼。您可以從 Microsoft 視覺工作室網站下載這些。

  4. 為下列項目設定您的開發環境 AWS SDK for .NET：

    1. 設定您的 AWS 認證。建議您建立共用認證檔案。

      如需指示，請參閱 AWSAWS SDK for .NET 開發人員指南中的使用認證檔案設定認證。

    2. 設定您的預設值 AWS 區域。若要瞭解如何操作，請參閱AWS 區域 選取。

      如需可用區域的完整 Amazon QLDB 單，請參閱 AWS 一般參考.

接下來，您可以設定基本的範例應用程式並執行簡短程式碼範例，或者您也可以將驅動程式安裝在現有的. NET項目。

  • 若要在現有專案 AWS SDK for .NET 中安裝QLDB驅動程式和，請繼續執行安裝。

  • 若要設定專案並執行展示分類帳上基本資料交易的簡短程式碼範例，請參閱快速入門教學。

安裝

使用 NuGet 套件管理員安裝的QLDB驅動程式。 NET。我們建議您使用 Visual Studio 或您選擇IDE的新增專案相依性。驅動程序包名稱是 Amazon。 QLDB. 驅動程式。

例如，在 Visual Studio 中，開啟 [工具] 功能表上的 [P NuGet ackage 管理員主控台]。然後，在提示符下輸入以下命PM>令。

PM> Install-Package Amazon.QLDB.Driver

安裝驅動程式也會安裝其相依性，包括 AWS SDK for .NET 和 Amazon Ion 套件。

安裝離子對象映射器

QLDB驅動程式的 1.3.0 版本。 NET引入了對接受和返回原生 C＃ 數據類型的支持，而無需使用 Amazon Ion。要使用此功能，請將以下軟件包添加到您的項目中。

  • Amazon。 QLDB.driver.Seri化-可以將Ion 值映射到 C＃ 普通舊CLR對象（POCO）的庫，而相反。這個 Ion 物件對應程式可讓您的應用程式直接與原生 C# 資料類型互動，而不需要使用 Ion。如需如何使用此程式庫的簡短指南，請參閱 GitHub 儲存庫awslabs/amazon-qldb-driver-dotnet中的 SERIALIZATION.md 檔案。

若要安裝此套件，請輸入下列指令。

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

如需如何在分類帳上執行基本資料交易的簡短程式碼範例，請參閱食譜參考。