用の Amazon QLDBドライバー。NET - Amazon Quantum 台帳データベース (Amazon QLDB)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

用の Amazon QLDBドライバー。NET

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon Ledger QLDB を Amazon Aurora Postgre に移行するSQL」を参照してください。

台帳内のデータを操作するには、 AWS が提供するドライバーを使用して、Microsoft NET. アプリケーションQLDBから Amazon に接続できます。ドライバーは をターゲットとします。NET スタンダード 2.0。具体的には、 をサポートしています。NET Core (LTS) 2.1+ および 。NET フレームワーク 4.5.2 以降。互換性の詳細については、「」を参照してください。NET Microsoft Docs サイトの標準

Amazon Ion 型とネイティブ C# 型を手動で変換する必要性を完全に回避するために、Ion オブジェクトマッパーを使用することを強くお勧めします。

以下のトピックでは、 のQLDBドライバーの使用を開始する方法について説明しますNET。

ドライバーに関するリソース

ドライバーでNETサポートされる機能の詳細については、以下のリソースを参照してください。

前提条件

のQLDBドライバーの使用を開始する前にNET、以下を実行する必要があります。

  1. AWS 「」のセットアップ手順に従ってくださいAmazon へのアクセス QLDB。これには以下が含まれます。

    1. にサインアップします AWS。

    2. 適切なQLDBアクセス許可を持つユーザーを作成します。

    3. 開発に必要なプログラムへのアクセスを提供します。

  2. をダウンロードしてインストールします。NET Microsoft の Core SDKバージョン 2.1 以降。 はサイトをダウンロードします。 NET

  3. (オプション) Visual Studio、Visual Studio for Mac、Visual Studio Code など、任意の統合開発環境 (IDE) をインストールします。これらの IDE は Microsoft Visual Studio サイトからダウンロードできます。

  4. AWS SDK for .NET の開発環境を設定します。

    1. AWS 認証情報を設定します。共有認証情報ファイルを作成することをお勧めします。

      手順については、「AWS SDK for .NET デベロッパーガイド」の「Configuring AWS credentials using a credentials file」を参照してください。

    2. デフォルトの AWS リージョンを設定します。方法については、「AWS リージョン selection」を参照してください。

      利用可能なリージョンの完全なリストについては、「」の「Amazon QLDBエンドポイントとクォータ」を参照してくださいAWS 全般のリファレンス

次に、基本的なサンプルアプリケーションを設定し、短いコード例を実行するか、既存の プロジェクトにドライバーをインストールできます。NET

  • QLDB ドライバーと を既存のプロジェクト AWS SDK for .NET にインストールするには、「」に進みますインストール

  • プロジェクトを設定し、台帳の基本的なデータトランザクションを示す短いコード例については、「クイックスタートチュートリアル」を参照してください。

インストール

NuGet パッケージマネージャーを使用して、 のQLDBドライバーをインストールしますNET。プロジェクトの依存関係を追加するには、Visual Studio またはIDE任意の を使用することをお勧めします。ドライバーパッケージ名は Amazon ですQLDB。ドライバー

例えば、Visual Studio で、ツールメニューでNuGet パッケージマネージャーコンソールを開きます。次に、PM> プロンプトで以下のコマンドを入力します。

PM> Install-Package Amazon.QLDB.Driver

ドライバーをインストールすると、 AWS SDK for .NET や Amazon Ion パッケージなどの依存関係もインストールされます。

Ion オブジェクトマッパーをインストールする

用QLDBドライバーのバージョン 1.3.0。NET では、Amazon Ion を操作することなく、ネイティブ C# データ型を受け入れて返すためのサポートが導入されています。この機能を使用するには、次のパッケージをプロジェクトに追加してください。

  • AmazonQLDBDriver.Serialization – Ion 値を C# プレーンな古いCLRオブジェクト (POCO) にマッピングできるライブラリ。逆の場合も同様です。この Ion オブジェクトマッパーを使用すると、アプリケーションが Ion を操作しなくてもネイティブ C# データ型と直接やり取りできるようになります。このライブラリの使用方法に関する簡単なガイドについては、 GitHub リポジトリ の SERIALIZATION.md ファイルを参照してくださいawslabs/amazon-qldb-driver-dotnet

次のコマンドを入力して、このパッケージをインストールします。

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

台帳に対して基本的なデータトランザクションを実行する方法を示す短いコード例については、「クックブックリファレンス」を参照してください。