Azure Cosmos DB for NoSQL SDK を使用して複数リージョンの書き込みアカウントに接続する

CosmosClientBuilder クラスは、コンテナーに接続して操作を実行する SDK クライアントをビルドするように設計されたフルーエントクラスです。 Azure Cosmos DB for NoSQL アカウントが複数リージョンの書き込み用に既に構成されている場合は、ビルダーを使用して、書き込み操作用に優先アプリケーションリージョンを構成できます。

このラボでは、リージョンが複数の Azure Cosmos DB for NoSQL アカウントを構成し、複数リージョンの書き込みを有効にします。その後、SDK を使用して、特定のリージョンに対して操作を実行します。

開発環境を準備する

このラボで作業している環境に DP-420 のラボコードのリポジトリをまだクローンしていない場合は、次の手順に従ってクローンします。それ以外の場合は、以前にクローンしたフォルダーを Visual Studio Code で開きます。

Visual Studio Code を起動します。

📝 Visual Studio Code インターフェイスについてまだよく理解していない場合は、作業の開始に関するドキュメントをご覧ください
コマンドパレットを開き、Git: Clone を実行して、任意のローカルフォルダーに https://github.com/microsoftlearning/dp-420-cosmos-db-dev GitHub リポジトリをクローンします。

💡 Ctrl + Shift + P キーボードショートカットを使用してコマンドパレットを開くことができます。
リポジトリが複製されたら、Visual Studio Code で選択したローカルフォルダーを開きます。

Azure Cosmos DB for NoSQL アカウントを作成する

Azure Cosmos DB は、複数の API をサポートするクラウドベースの NoSQL データベースサービスです。 Azure Cosmos DB アカウントを初めてプロビジョニングするときに、そのアカウントでサポートする API (たとえば、Mongo API や NoSQL API) を選択します。 Azure Cosmos DB for NoSQL アカウントのプロビジョニングが完了したら、エンドポイントとキーを取得し、Azure SDK for .NET または任意の他の SDK を使用して Azure Cosmos DB for NoSQL アカウントに接続する際に使用できます。

新しい Web ブラウザーウィンドウまたはタブで、Azure portal (portal.azure.com) に移動します。
ご利用のサブスクリプションに関連付けられている Microsoft 資格情報を使用して、ポータルにサインインします。

[+ リソースの作成] を選択し、Cosmos DB を検索して、新しい Azure Cosmos DB for NoSQL アカウントリソースを作成します。以下を設定して、残りの設定はすべて既定値のままにします。

設定	Value
サブスクリプション	’‘既存の Azure サブスクリプション’’
リソースグループ	’‘既存のリソースグループを選択するか、新しいものを作成します’’
アカウント名	’‘グローバルに一意の名前を入力します’’
場所	’‘使用可能なリージョンを選びます’’
容量モード	プロビジョニング済みスループット
Apply Free Tier Discount (Free レベル割引の適用)	適用しない

📝 ご利用のラボ環境には、新しいリソースグループを作成できない制限が存在する場合があります。その場合は、事前に作成されている既存のリソースグループを使用します。

デプロイタスクが完了するまで待ってから、このタスクを続行してください。
新しく作成した Azure Cosmos DB アカウントリソースにアクセスし、[データをグローバルにレプリケートする] ペインに移動します。
[データをグローバルにレプリケートする] ペインで、さらに少なくとも 1 つのリージョンをアカウントに追加します。
[データをグローバルにレプリケートする] ペインのまま、複数リージョンの書き込みを有効にしてから、変更内容を保存します。
このタスクを続行する前に、レプリケーションタスクが完了するのを待ちます。

📝 この操作には、5 から 10 分ほどかかる場合があります。
作成した追加リージョンが少なくとも 1 つあることを確認します。このリージョン値は、この演習で後ほど使用します。
リソースブレードで、[データエクスプローラー] ペインに移動します。
[データエクスプローラー] ペインで、 [新しいコンテナー] を選択します。

[新しいコンテナー] ポップアップで、各設定に次の値を入力してから [OK] を選択します。

設定	Value
データベース ID	新規作成 \| `cosmicworks`
コンテナー間でスループットを共有する	選択しない
コンテナー ID	`products`
パーティションキー	`/categoryId`
コンテナーのスループット	手動 \| 400

[データエクスプローラー] ペインに戻り、cosmicworks データベースノードを展開して、階層内の products コンテナーノードを確認します。
リソースブレードで、[キー] ペインに移動します。
このペインには、SDK からアカウントに接続するために必要な接続の詳細と資格情報が含まれています。具体的な内容は次のとおりです。
1. [URI] フィールドに注目します。このエンドポイントの値は、この演習で後ほど使用します。
2. [主キー] フィールドに注目してください。このキーの値は、この演習で後ほど使用します。
Visual Studio Code に戻ります。

SDK から Azure Cosmos DB for NoSQL アカウントに接続する

新しく作成したアカウントの資格情報を使用して、SDK クラスに接続し、新しいデータベースとコンテナーインスタンスを作成します。次に、データエクスプローラーを使用して、Azure portal でインスタンスが存在することを検証します。

[エクスプローラー] ペインで、22-sdk-multi-region フォルダーを参照します。
22-sdk-multi-region フォルダーのコンテキストメニューを開き、[統合ターミナルで開く] を選択して新しいターミナルインスタンスを開きます。

📝 このコマンドを実行すると、ターミナルが開き、開始ディレクトリが既に 22-sdk-multi-region フォルダーに設定されています。
dotnet build コマンドを使用してプロジェクトをビルドします。
```
 dotnet build
```
📝 コンパイラから、endpoint および key 変数は現在使用されていないという警告が表示される場合があります。これらの変数はこのタスクで使用しますので、この警告は無視しても問題ありません。
統合ターミナルを閉じます。
product.cs コードファイルを開きます。
Product レコードとその対応するプロパティを確認します。具体的には、このラボでは id、name、および categoryId プロパティを使用します。
Visual Studio Code の [エクスプローラー] ペインに戻り、script.cs コードファイルを開きます。

📝 [Microsoft.Azure.Cosmos][nuget.org/packages/microsoft.azure.cosmos/3.22.1] ライブラリは、既に NuGet から事前にインポートされています。
endpoint という名前の string 変数を見つけます。その値を、先ほど作成した Azure Cosmos DB アカウントのエンドポイントに設定します。
```
 string endpoint = "<cosmos-endpoint>";
```
📝 たとえば、ご自分のエンドポイントが https://dp420.documents.azure.com:443/ の場合、C# ステートメントは string endpoint = “https://dp420.documents.azure.com:443/”; になります。
key という名前の string 変数を見つけます。その値を、先ほど作成した Azure Cosmos DB アカウントのキーに設定します。
```
 string key = "<cosmos-key>";
```
📝 たとえば、キーが fDR2ci9QgkdkvERTQ== の場合、C# ステートメントは string key = “fDR2ci9QgkdkvERTQ==”; になります。
script.cs コードファイルを保存します。

SDK の書き込みリージョンを構成する

フルーエントな WithApplicationRegion メソッドを使用して、ビルダークラスを使用して後続の操作の優先リージョンを構成します。

コンストラクターパラメーターとして endpoint および key 変数を渡して、builder という名前の CosmosClientBuilder クラスの新しいインスタンスを作成します。
```
 CosmosClientBuilder builder = new (endpoint, key);
```
ラボで先ほど作成した追加リージョンの名前を使用して、string 型の region という名前の新しい変数を作成します。たとえば、米国東部リージョンに Azure Cosmos DB for NoSQL アカウントを作成し、その後ブラジル南部を追加した場合は、文字列変数に以下を含めます。
```
 string region = "Brazil South"; 
```
💡 代わりに、Microsoft.Azure.Cosmos.Regions 静的クラスを使用して、異なる Azure リージョンの組み込みの文字列プロパティを含めることもできます。
WithApplicationRegion メソッドを region のパラメーターを指定して呼び出し、builder 変数で Build メソッドをフルーエントに呼び出し、using ステートメント内にカプセル化された CosmosClient 型の client という名前の変数に結果を格納します。
```
 using CosmosClient client = builder
     .WithApplicationRegion(region)
     .Build();
```
client 変数の GetContainer メソッドを使用し、データベースの名前 (cosmicworks) とコンテナーの名前 (products) を使って既存のコンテナーを取得します。
```
 Container container = client.GetContainer("cosmicworks", "products");
```
新しい Guid 値を生成し、id と categoryId という名前の 2 つの string 変数を作成し、結果を文字列として格納します。
```
 string id = $"{Guid.NewGuid()}";
 string categoryId = $"{Guid.NewGuid()}";
```
コンストラクターパラメーターとして id 変数、Polished Bike Frame の文字列値、categoryId 変数を渡して、Product 型の item という名前の新しい変数を作成します。
```
 Product item = new (id, "Polished Bike Frame", categoryId);
```
パラメーターとして item 変数を渡して、container 変数の CreateItemAsync<> メソッドを非同期に呼び出し、結果を response という名前の変数に格納します。
```
 var response = await container.CreateItemAsync<Product>(item);
```
Console.WriteLine 静的メソッドを呼び出して、応答の HTTP 状態コードと要求料金 (要求ユニット単位) を出力します。
```
 Console.WriteLine($"Status Code:\t{response.StatusCode}");
 Console.WriteLine($"Charge (RU):\t{response.RequestCharge:0.00}");
```

完了すると、コードファイルが次のようになるはずです。

 using Microsoft.Azure.Cosmos;
 using Microsoft.Azure.Cosmos.Fluent;

 string endpoint = "<cosmos-endpoint>";
 string key = "<cosmos-key>";    

 CosmosClientBuilder builder = new (endpoint, key);            
    
 string region = "West Europe";
    
 using CosmosClient client = builder
     .WithApplicationRegion(region)
     .Build();
    
 Container container = client.GetContainer("cosmicworks", "products");
    
 string id = $"{Guid.NewGuid()}";
 string categoryId = $"{Guid.NewGuid()}";
 Product item = new (id, "Polished Bike Frame", categoryId);
    
 var response = await container.CreateItemAsync<Product>(item);
    
 Console.WriteLine($"Status Code:\t{response.StatusCode}");
 Console.WriteLine($"Charge (RU):\t{response.RequestCharge:0.00}");

script.cs コードファイルを保存します。
Visual Studio Code で、22-sdk-multi-region フォルダーのコンテキストメニューを開き、[統合ターミナルで開く] を選択して新しいターミナルインスタンスを開きます。
dotnet run コマンドを使用して、プロジェクトをビルドして実行します。
```
 dotnet run
```
ターミナルからの出力を確認します。 HTTP 状態コードと要求料金 (RU 単位) がコンソールに出力されているはずです。
統合ターミナルを閉じます。
Visual Studio Code を閉じます。