翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
用の 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、以下を実行する必要があります。
-
AWS 「」のセットアップ手順に従ってくださいAmazon へのアクセス QLDB。これには以下が含まれます。
-
にサインアップします AWS。
-
適切なQLDBアクセス許可を持つユーザーを作成します。
-
開発に必要なプログラムへのアクセスを提供します。
-
-
をダウンロードしてインストールします。NET Microsoft の Core SDKバージョン 2.1 以降。 はサイトをダウンロードします。 NET
-
(オプション) Visual Studio、Visual Studio for Mac、Visual Studio Code など、任意の統合開発環境 (IDE) をインストールします。これらの IDE は Microsoft Visual Studio
サイトからダウンロードできます。 -
AWS SDK for .NET
の開発環境を設定します。 -
AWS 認証情報を設定します。共有認証情報ファイルを作成することをお勧めします。
手順については、「AWS SDK for .NET デベロッパーガイド」の「Configuring AWS credentials using a credentials file」を参照してください。
-
デフォルトの 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
台帳に対して基本的なデータトランザクションを実行する方法を示す短いコード例については、「クックブックリファレンス」を参照してください。