用の 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サポートされる機能の詳細については、以下のリソースを参照してください。

• API リファレンス

• ドライバーソースコード (GitHub）

• サンプルアプリケーションのソースコード (GitHub）

• Amazon Ion クックブック

• Ion オブジェクトマッパー (GitHub）

前提条件

の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

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