.NET 用 Amazon QLDB ドライバー

台帳内のデータを操作するには、AWS が提供するドライバーを使用して Microsoft .NET アプリケーションから Amazon QLDB に接続します。このドライバーは、.NET Standard 2.0 を対象としています。具体的には、.NET Core (LTS) 2.1+ および .NET Framework 4.5.2+ をサポートしています。互換性の詳細については、Microsoft Docs サイトの「.NET Standard」を参照してください。

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

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

トピック

• ドライバーに関するリソース
• 前提条件
• インストール
• クイックスタートチュートリアル
• クックブックリファレンス

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

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

• API リファレンス

• ドライバーのソースコード (GitHub)

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

• Amazon Ion クックブック

• イオンオブジェクトマッパー (GitHub)

前提条件

.NET 用 QLDB ドライバーの使用を開始する前に、次のことを行う必要があります。

1. 「Amazon QLDB へのアクセス」にある AWS の設定手順に従います。これには以下が含まれます。

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

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

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

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

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」を参照してください。

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

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

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

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

インストール

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

例えば、Visual Studio では、[Tools] (ツール) メニューの [NuGet Package Manager Console] (NuGet パッケージマネージャーコンソール) を開きます。次に、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 オブジェクトマッパーを使用すると、アプリケーションが Ion を操作しなくてもネイティブ C# データ型と直接やり取りできるようになります。このライブラリの使用方法に関する簡単なガイドについては、GitHub リポジトリ awslabs/amazon-qldb-driver-dotnet の Serialization.md ファイルを参照してください。

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

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

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