準備 - Training | Microsoft Learn

4 分

Azure Cosmos DB for NoSQL コンテナーにデータをインポートしてクエリを実行する .NET アプリケーションを構築します。ここでは、プロジェクトの全体的な目標と、インポートとクエリの機能を実装する方法について説明します。さらに、必要な API for NoSQL アカウントを設定する方法について説明します。

Illustration of the icon of an Azure Cosmos DB account.

プロジェクトの概要

このプロジェクトの目標は、API for NoSQL コンテナーに項目をアップロードしてクエリを実行する .NET コンソールアプリケーションを構築して検証することです。この .NET アプリケーションでは、Azure Cosmos DB for NoSQL 用の .NET SDK を使って、Azure 内のサービスインスタンスとやり取りします。プロジェクトコードでは、トランザクションバッチを使って、複数の関連項目を同時に作成します。また、プロジェクトコードでは、文字列として表されたクエリを使って、項目が正常にアップロードされたことを検証します。

次のフローチャートは、アプリで実行する必要があるビジネスロジックを示したものです。

実行する必要がある主なタスクは次のとおりです。

Azure Cosmos DB アカウントを作成し、接続文字列を取得します。
.NET コンソールアプリケーションを作成し、Microsoft.Azure.Cosmos SDK へのパッケージ参照を追加します。
データベースとコンテナーのリソースを作成します。
単純な操作として 1 つの項目を追加します。
4 つの項目を追加するトランザクションバッチを作成します。
クエリを実行し、その結果を観察します。

セットアップ

このプロジェクトを完了するには、API for NoSQL アカウントが必要です。

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

API for NoSQL アカウントを使って、このプロジェクトで作成するデータを格納し、クエリを実行します。このセクションでは、Azure Cloud Shell ターミナルで直接 Azure CLI を使って新しいアカウントを作成する手順について説明します。

suffix という名前の新しいシェル変数を、乱数を使用して作成します。 [sandbox resource group name] リソースグループ内に、NoSQL 用 API の新しいアカウントを作成します。
```
let suffix=$RANDOM*$RANDOM

az cosmosdb create \
    --resource-group "<rgn>[sandbox resource group name]</rgn>" \
    --name "mslearn-$suffix" \
    --locations "regionName=westus"
```
重要

このリソースグループは、サンドボックスによって既に作成されています。
新しいアカウントが作成されたら、コマンドが完了するまで待ちます。新しいアカウントの作成には、数分かかることがあります。

ヒント

Azure portal を使用して、NoSQL 用 API の新しいアカウントに移動することができます。

アカウントの接続文字列を取得する

これで NoSQL 用 API アカウントを入手したので、Azure CLI から az cosmosdb keys list コマンドを使用して、そのアカウントの資格情報を取得することができます。このセクションでは、コマンドの出力をフィルター処理して、接続文字列を 1 つだけ返します。

まず、最近作成された NoSQL 用 API アカウントの名前を取得します。

let resourceGroup="<rgn>[sandbox resource group name]</rgn>"

az cosmosdb list \
    --resource-group $resourceGroup \
    --query "sort_by([].{name:name,created:systemData.createdAt}, &created)" \
    --output table

次に、その最近作成されたアカウントの一覧から、1 番目のアカウントの Primary SQL Connection String 資格情報を取得します。

let resourceGroup="<rgn>[sandbox resource group name]</rgn>"

az cosmosdb keys list \
    --resource-group $resourceGroup \
    --name $(az cosmosdb list \
        --resource-group $resourceGroup \
        --query "sort_by([].{name:name,created:systemData.createdAt}, &created)[0].name" \
        --output tsv) \
    --type connection-strings \
    --query "connectionStrings[?description=='Primary SQL Connection String'].connectionString" \
    --output tsv

この接続文字列の値を記録します。このプロジェクトの後半で接続文字列を使用して、このアカウントに接続します。

開発環境を構成する

開発コンテナー環境は、このプロジェクトのすべての演習を完了するために必要なすべての依存関係で使用できます。開発コンテナーは、GitHub Codespaces で実行することも、Visual Studio Code をローカルで使用して実行することもできます。

ブラウザで開発する
ローカルでの開発

GitHub Codespaces では、Web 用 Visual Studio Code をブラウザーベースのユーザーインターフェイスとして使用し、GitHub によって管理される開発コンテナーを実行します。正しい開発者ツールと、このトレーニングモジュールを完了するために事前インストールされた依存関係を持つ最も簡単な開発環境として、GitHub Codespaces を使用します。

重要

すべての GitHub アカウントでは、2 つのコアインスタンスで毎月最大 60 時間無料で Codespaces を使用できます。

azure-samples/cosmos-db-dotnet テンプレートを使用して、新しい GitHub codespace を作成します。
[codespace の作成] ページ上で、codespace の構成設定を確認し、それから [新しい Codespace の作成] を選択します。
Codespace が起動するまで待ちます。この起動プロセスには数分かかることがあります。
codespace で新しいターミナルを開きます。
.NET 8 が環境にインストールされていることを確認します。
```
dotnet --list-sdks
```
ターミナルを閉じます。

このプロジェクトの残りの演習は、この開発コンテナーのコンテキストで行われます。

Visual Studio Code の Dev Containers 拡張機能を利用するには、ローカルコンピューターに Docker をインストールする必要があります。拡張機能は、Docker ホストを、正しい開発者ツールと、このトレーニングモジュールを完了するために事前インストールされた依存関係と合わせてローカルで使用することで開発コンテナーをホストします。

Visual Studio Code 内で、GitHub から azure-samples/cosmos-db-dotnet テンプレートリポジトリを開きます。
新しいターミナルを開きます。
.NET 8 が環境にインストールされていることを確認します。
```
dotnet --list-sdks
```
ターミナルを閉じます。