クイック スタート:Azure Cosmos DB SQL API リソースを管理する .NET コンソール アプリを構築するQuickstart: Build a .NET console app to manage Azure Cosmos DB SQL API resources

.NET 用の Azure Cosmos DB SQL API クライアント ライブラリの概要について説明します。Get started with the Azure Cosmos DB SQL API client library for .NET. このドキュメントの手順に従って .NET パッケージをインストールし、アプリをビルドして、Azure Cosmos DB に格納されているデータに対する基本的な CRUD 操作のサンプル コードを試してみてください。Follow the steps in this doc to install the .NET package, build an app, and try out the example code for basic CRUD operations on the data stored in Azure Cosmos DB.

Azure Cosmos DB、Microsoft のグローバルに配布されるマルチモデル データベース サービスです。Azure Cosmos DB is Microsoft’s globally distributed multi-model database service. Azure Cosmos DB を使用すると、キー/値データベース、ドキュメント データベース、およびグラフ データベースをすばやく作成し、クエリを実行できます。You can use Azure Cosmos DB to quickly create and query key/value, document, and graph databases. .NET 用の Azure Cosmos DB SQL API クライアント ライブラリを使用して、次のことを行います。Use the Azure Cosmos DB SQL API client library for .NET to:

  • Azure Cosmos データベースとコンテナーを作成するCreate an Azure Cosmos database and a container
  • コンテナーにサンプル データを追加するAdd sample data to the container
  • データを照会するQuery the data
  • データベースを削除するDelete the database

API リファレンスのドキュメント | ライブラリのソース コード | パッケージ (NuGet)API reference documentation | Library source code | Package (NuGet)

前提条件Prerequisites

設定Setting up

このセクションでは、Azure Cosmos アカウントを作成し、.NET 用 Azure Cosmos DB SQL API クライアント ライブラリを使用してリソースを管理するプロジェクトを設定する手順について説明します。This section walks you through creating an Azure Cosmos account and setting up a project that uses Azure Cosmos DB SQL API client library for .NET to manage resources. この記事で説明するコード例では FamilyDatabase データベースと、そのデータベース内にファミリ メンバー (各ファミリ メンバーが項目) を作成します。The example code described in this article creates a FamilyDatabase database and family members (each family member is an item) within that database. 各ファミリ メンバーには Id, FamilyName, FirstName, LastName, Parents, Children, Address, などのプロパティがあります。Each family member has properties such as Id, FamilyName, FirstName, LastName, Parents, Children, Address,. LastName プロパティは、コンテナーのパーティション キーとして使用されます。The LastName property is used as the partition key for the container.

Azure Cosmos アカウントを作成するCreate an Azure Cosmos account

[Azure Cosmos DB を無料で試す] オプションを使用して Azure Cosmos アカウントを作成する場合は、種類が SQL API の Azure Cosmos DB アカウントを作成する必要があります。If you use the Try Azure Cosmos DB for free option to create an Azure Cosmos account, you must create an Azure Cosmos DB account of type SQL API. Azure Cosmos DB テスト アカウントは既に作成されています。An Azure Cosmos DB test account is already created for you. アカウントを明示的に作成する必要はないため、このセクションをスキップして次のセクションに進むことができます。You don't have to create the account explicitly, so you can skip this section and move to the next section.

独自の Azure サブスクリプションを所有しているか、または無料のサブスクリプションを作成した場合は、Azure Cosmos アカウントを明示的に作成する必要があります。If you have your own Azure subscription or created a subscription for free, you should create an Azure Cosmos account explicitly. 次のコードでは、セッションの整合性を持つ Azure Cosmos アカウントを作成します。The following code will create an Azure Cosmos account with session consistency. アカウントは South Central USNorth Central US でレプリケートされます。The account is replicated in South Central US and North Central US.

Azure Cloud Shell を使用して、Azure Cosmos アカウントを作成できます。You can use Azure Cloud Shell to create the Azure Cosmos account. Azure Cloud Shell は、Azure リソースを管理するための、ブラウザーでアクセスできる対話形式の認証されたシェルです。Azure Cloud Shell is an interactive, authenticated, browser-accessible shell for managing Azure resources. Bash または PowerShell どちらかのシェル エクスペリエンスを作業方法に合わせて柔軟に選択できます。It provides the flexibility of choosing the shell experience that best suits the way you work, either Bash or PowerShell. このクイックスタートでは、 [Bash] モードを選択します。For this quickstart, choose Bash mode. Azure Cloud Shell ではストレージ アカウントも必要です。これはプロンプトが表示されたら作成できます。Azure Cloud Shell also requires a storage account, you can create one when prompted.

次のコードの横にある [試してみる] ボタンを選択し、 [Bash] モードを選択します。 [ストレージ アカウントを作成する] を選択して Cloud Shell にログインします。Select the Try It button next to the following code, choose Bash mode select create a storage account and login to Cloud Shell. 次に、次のコードをコピーして Azure Cloud Shell に貼り付けて実行します。Next copy and paste the following code to Azure cloud shell and run it. Azure Cosmos アカウント名はグローバルに一意である必要があります。必ず mysqlapicosmosdb 値を更新してからコマンドを実行してください。The Azure Cosmos account name must be globally unique, make sure to update the mysqlapicosmosdb value before you run the command.


# Set variables for the new SQL API account, database, and container
resourceGroupName='myResourceGroup'
location='southcentralus'

# The Azure Cosmos account name must be globally unique, make sure to update the `mysqlapicosmosdb` value before you run the command
accountName='mysqlapicosmosdb'

# Create a resource group
az group create \
    --name $resourceGroupName \
    --location $location

# Create a SQL API Cosmos DB account with session consistency and multi-master enabled
az cosmosdb create \
    --resource-group $resourceGroupName \
    --name $accountName \
    --kind GlobalDocumentDB \
    --locations regionName="South Central US" failoverPriority=0 --locations regionName="North Central US" failoverPriority=1 \
    --default-consistency-level "Session" \
    --enable-multiple-write-locations true

Azure Cosmos アカウントの作成にはしばらく時間がかかります。操作が正常に終了したら、確認出力が表示されます。The creation of the Azure Cosmos account takes a while, once the operation is successful, you can see the confirmation output. コマンドが正常に終了したら、Azure portal にサインインし、指定した名前の Azure Cosmos アカウントが存在することを確認します。After the command completes successfully, sign into the Azure portal and verify that the Azure Cosmos account with the specified name exists. リソースの作成後に、[Azure Cloud Shell] ウィンドウを閉じることができます。You can close the Azure Cloud Shell window after the resource is created.

新しい .NET アプリを作成するCreate a new .NET app

好みのエディターまたは IDE で、新しい .NET アプリケーションを作成します。Create a new .NET application in your preferred editor or IDE. ローカル コンピューターから Windows コマンド プロンプトまたはターミナル ウィンドウを開きます。Open the Windows command prompt or a Terminal window from your local computer. 次のセクションではコマンド プロンプトまたはターミナルからすべてのコマンドを実行します。You will run all the commands in the next sections from the command prompt or terminal. 次の dotnet new コマンドを実行して、todo という名前の新しいアプリを作成します。Run the following dotnet new command to create a new app with the name todo. 作成したプロジェクト ファイル内には、--langVersion パラメーターによって、LangVersion プロパティが設定されます。The --langVersion parameter sets the LangVersion property in the created project file.

dotnet new console --langVersion 7.1 -n todo

新しく作成されたアプリ フォルダーにディレクトリを変更します。Change your directory to the newly created app folder. 次を使用してアプリケーションをビルドできます。You can build the application with:

cd todo
dotnet build

ビルドからの予想される出力は、次のようになります。The expected output from the build should look something like this:

  Restore completed in 100.37 ms for C:\Users\user1\Downloads\CosmosDB_Samples\todo\todo.csproj.
  todo -> C:\Users\user1\Downloads\CosmosDB_Samples\todo\bin\Debug\netcoreapp2.2\todo.dll
  todo -> C:\Users\user1\Downloads\CosmosDB_Samples\todo\bin\Debug\netcoreapp2.2\todo.Views.dll

Build succeeded.
    0 Warning(s)
    0 Error(s)

Time Elapsed 00:00:34.17

Azure Cosmos DB パッケージをインストールするInstall the Azure Cosmos DB package

アプリケーション ディレクトリ内で、dotnet add package コマンドを使用して .NET Core 用の Azure Cosmos DB クライアント ライブラリをインストールします。While still in the application directory, install the Azure Cosmos DB client library for .NET Core by using the dotnet add package command.

dotnet add package Microsoft.Azure.Cosmos

Azure portal から Azure Cosmos アカウントの資格情報をコピーするCopy your Azure Cosmos account credentials from the Azure portal

サンプル アプリケーションは、Azure Cosmos アカウントに対する認証を行う必要があります。The sample application needs to authenticate to your Azure Cosmos account. 認証するには、Azure Cosmos アカウントの資格情報をアプリケーションに渡す必要があります。To authenticate, you should pass the Azure Cosmos account credentials to the application. 次の手順に従って、Azure Cosmos アカウントの資格情報を取得します。Get your Azure Cosmos account credentials by following these steps:

  1. Azure Portal にサインインします。Sign in to the Azure portal.

  2. Azure Cosmos アカウントに移動します。Navigate to your Azure Cosmos account.

  3. [キー] ウィンドウを開き、アカウントの [URI][プライマリ キー] をコピーします。Open the Keys pane and copy the URI and PRIMARY KEY of your account. 次の手順では、URI とキーの値を環境変数に追加します。You will add the URI and keys values to an environment variable in the next step.

環境変数を設定するSet the environment variables

アカウントの [URI][プライマリ キー] をコピーしたら、アプリケーションを実行しているローカル コンピューター上の新しい環境変数に保存します。After you have copied the URI and PRIMARY KEY of your account, save them to a new environment variable on the local machine running the application. 環境変数を設定するには、コンソール ウィンドウを開き、次のコマンドを実行します。To set the environment variable, open a console window, and run the following command. <Your_Azure_Cosmos_account_URI><Your_Azure_Cosmos_account_PRIMARY_KEY> の値は必ず置き換えてください。Make sure to replace <Your_Azure_Cosmos_account_URI> and <Your_Azure_Cosmos_account_PRIMARY_KEY> values.

WindowsWindows

setx EndpointUrl "<Your_Azure_Cosmos_account_URI>"
setx PrimaryKey "<Your_Azure_Cosmos_account_PRIMARY_KEY>"

LinuxLinux

export EndpointUrl = "<Your_Azure_Cosmos_account_URI>"
export PrimaryKey = "<Your_Azure_Cosmos_account_PRIMARY_KEY>"

MacOSMacOS

export EndpointUrl = "<Your_Azure_Cosmos_account_URI>"
export PrimaryKey = "<Your_Azure_Cosmos_account_PRIMARY_KEY>"

オブジェクト モデルObject model

アプリケーションのビルドを開始する前に、Azure Cosmos DB のリソースの階層と、これらのリソースの作成とアクセスに使用されるオブジェクト モデルについて説明します。Before you start building the application, let's look into the hierarchy of resources in Azure Cosmos DB and the object model used to create and access these resources. Azure Cosmos DB によって、次の順序でリソースが作成されます。The Azure Cosmos DB creates resources in the following order:

  • Azure Cosmos アカウントAzure Cosmos account
  • データベースDatabases
  • ContainersContainers
  • アイテムItems

さまざまなエンティティの階層の詳細については、Azure Cosmos DB のデータベース、コンテナー、および項目の操作に関する記事を参照してください。To learn in more about the hierarchy of different entities, see the working with databases, containers, and items in Azure Cosmos DB article. これらのリソースとやり取りするには、以下の .NET クラスを使用します。You will use the following .NET classes to interact with these resources:

  • CosmosClient - このクラスは、Azure Cosmos DB サービスのクライアント側の論理表現を提供します。CosmosClient - This class provides a client-side logical representation for the Azure Cosmos DB service. このクライアント オブジェクトは、サービスに対する要求の構成と実行に使用されます。The client object is used to configure and execute requests against the service.

  • CreateDatabaseIfNotExistsAsync - このメソッドによって、非同期操作としてデータベース リソースが (存在しない場合は) 作成されるか、(既に存在する場合は) 取得されます。CreateDatabaseIfNotExistsAsync - This method creates (if doesn't exist) or gets (if already exists) a database resource as an asynchronous operation.

  • CreateContainerIfNotExistsAsync - このメソッドによって、非同期操作としてコンテナーが (存在しない場合は) 作成されるか、(既に存在する場合は) 取得されます。CreateContainerIfNotExistsAsync- - This method creates (if it doesn't exist) or gets (if it already exists) a container as an asynchronous operation. 応答から状態コードを確認して、コンテナーが新しく作成された (201) か、既存のコンテナーが返された (200) かを判断できます。You can check the status code from the response to determine whether the container was newly created (201) or an existing container was returned (200).

  • CreateItemAsync - このメソッドによって、コンテナー内に項目が作成されます。CreateItemAsync - This method creates an item within the container.

  • UpsertItemAsync - このメソッドでは、アイテムがまだ存在しない場合、コンテナー内にアイテムが作成され、既に存在する場合、アイテムが置換されます。UpsertItemAsync - This method creates an item within the container if it doesn't already exist or replaces the item if it already exists.

  • GetItemQueryIterator - このメソッドにより、SQL ステートメントとパラメーター化された値を利用して Azure Cosmos データベースのコンテナーの下でアイテムに対するクエリが作成されます。GetItemQueryIterator - This method creates a query for items under a container in an Azure Cosmos database using a SQL statement with parameterized values.

  • DeleteAsync - 指定されたデータベースを Azure Cosmos アカウントから削除します。DeleteAsync - Deletes the specified database from your Azure Cosmos account. DeleteAsync メソッドでは、データベースのみが削除されます。DeleteAsync method only deletes the database. Cosmosclient インスタンスの破棄は個別に行われる必要があります (DeleteDatabaseAndCleanupAsync メソッドで実行されます)。Disposing of the Cosmosclient instance should happen separately (which it does in the DeleteDatabaseAndCleanupAsync method.

コード例Code examples

この記事で説明されているサンプル コードでは、Azure Cosmos DB でファミリ データベースを作成します。The sample code described in this article creates a family database in Azure Cosmos DB. ファミリ データベースには、名前、住所、場所、関連付けられている親、子供、ペットなどのファミリの詳細が含まれています。The family database contains family details such as name, address, location, the associated parents, children, and pets. データを Azure Cosmos アカウントに設定する前に、ファミリ項目のプロパティを定義します。Before populating the data to your Azure Cosmos account, define the properties of a family item. サンプル アプリケーションのルート レベルに Family.cs という名前の新しいクラスを作成し、次のコードを追加します。Create a new class named Family.cs at the root level of your sample application and add the following code to it:

using Newtonsoft.Json;

namespace todo
{
    public class Family
    {
        [JsonProperty(PropertyName = "id")]
        public string Id { get; set; }
        public string LastName { get; set; }
        public Parent[] Parents { get; set; }
        public Child[] Children { get; set; }
        public Address Address { get; set; }
        public bool IsRegistered { get; set; }
        // The ToString() method is used to format the output, it's used for demo purpose only. It's not required by Azure Cosmos DB
        public override string ToString()
        {
            return JsonConvert.SerializeObject(this);
        }
    }

    public class Parent
    {
        public string FamilyName { get; set; }
        public string FirstName { get; set; }
    }

    public class Child
    {
        public string FamilyName { get; set; }
        public string FirstName { get; set; }
        public string Gender { get; set; }
        public int Grade { get; set; }
        public Pet[] Pets { get; set; }
    }

    public class Pet
    {
        public string GivenName { get; set; }
    }

    public class Address
    {
        public string State { get; set; }
        public string County { get; set; }
        public string City { get; set; }
    }
}

using ディレクティブの追加とクライアント オブジェクトの定義とAdd the using directives & define the client object

プロジェクト ディレクトリからエディターで Program.cs ファイルを開き、アプリケーションの先頭に次の using ディレクティブを追加します。From the project directory, open the Program.cs file in your editor and add the following using directives at the top of your application:


using System;
using System.Threading.Tasks;
using System.Configuration;
using System.Collections.Generic;
using System.Net;
using Microsoft.Azure.Cosmos;

Program.cs ファイルに、前の手順で設定した環境変数を読み取るコードを追加します。To the Program.cs file, add code to read the environment variables that you have set in the previous step. CosmosClientDatabase、および Container オブジェクトを定義します。Define the CosmosClient, Database, and the Container objects. 次に、Azure Cosmos アカウント リソースを管理する GetStartedDemoAsync メソッドを呼び出すコードを main メソッドに追加します。Next add code to the main method that calls the GetStartedDemoAsync method where you manage Azure Cosmos account resources.

namespace todo
{
public class Program
{

    /// The Azure Cosmos DB endpoint for running this GetStarted sample.
    private string EndpointUrl = Environment.GetEnvironmentVariable("EndpointUrl");

    /// The primary key for the Azure DocumentDB account.
    private string PrimaryKey = Environment.GetEnvironmentVariable("PrimaryKey");

    // The Cosmos client instance
    private CosmosClient cosmosClient;

    // The database we will create
    private Database database;

    // The container we will create.
    private Container container;

    // The name of the database and container we will create
    private string databaseId = "FamilyDatabase";
    private string containerId = "FamilyContainer";

    public static async Task Main(string[] args)
    {
       try
       {
           Console.WriteLine("Beginning operations...\n");
           Program p = new Program();
           await p.GetStartedDemoAsync();

        }
        catch (CosmosException de)
        {
           Exception baseException = de.GetBaseException();
           Console.WriteLine("{0} error occurred: {1}", de.StatusCode, de);
        }
        catch (Exception e)
        {
            Console.WriteLine("Error: {0}", e);
        }
        finally
        {
            Console.WriteLine("End of demo, press any key to exit.");
            Console.ReadKey();
        }
    }
}
}

データベースを作成するCreate a database

program.cs クラス内に CreateDatabaseAsync メソッドを定義します。Define the CreateDatabaseAsync method within the program.cs class. このメソッドによって、FamilyDatabase が作成されます (まだ存在しない場合)。This method creates the FamilyDatabase if it doesn't already exist.

private async Task CreateDatabaseAsync()
{
    // Create a new database
    this.database = await this.cosmosClient.CreateDatabaseIfNotExistsAsync(databaseId);
    Console.WriteLine("Created Database: {0}\n", this.database.Id);
}

コンテナーを作成するCreate a container

program.cs クラス内に CreateContainerAsync メソッドを定義します。Define the CreateContainerAsync method within the program.cs class. このメソッドによって、FamilyContainer が作成されます (まだ存在しない場合)。This method creates the FamilyContainer if it doesn't already exist.

/// Create the container if it does not exist. 
/// Specifiy "/LastName" as the partition key since we're storing family information, to ensure good distribution of requests and storage.
private async Task CreateContainerAsync()
{
    // Create a new container
    this.container = await this.database.CreateContainerIfNotExistsAsync(containerId, "/LastName");
    Console.WriteLine("Created Container: {0}\n", this.container.Id);
}

項目を作成するCreate an item

次のコードを使用して、AddItemsToContainerAsync メソッドを追加してファミリ項目を作成します。Create a family item by adding the AddItemsToContainerAsync method with the following code. CreateItemAsync または UpsertItemAsync のメソッドを使用し、アイテムを作成できます。You can use the CreateItemAsync or UpsertItemAsync methods to create an item:

private async Task AddItemsToContainerAsync()
{
    // Create a family object for the Andersen family
    Family andersenFamily = new Family
    {
        Id = "Andersen.1",
        LastName = "Andersen",
        Parents = new Parent[]
        {
           new Parent { FirstName = "Thomas" },
           new Parent { FirstName = "Mary Kay" }
        },
        Children = new Child[]
        {
           new Child
            {
                FirstName = "Henriette Thaulow",
                Gender = "female",
                Grade = 5,
                Pets = new Pet[]
                {
                    new Pet { GivenName = "Fluffy" }
                }
            }
        },
        Address = new Address { State = "WA", County = "King", City = "Seattle" },
        IsRegistered = false
    };

try
{
    // Read the item to see if it exists. ReadItemAsync will throw an exception if the item does not exist and return status code 404 (Not found).
    ItemResponse<Family> andersenFamilyResponse = await this.container.ReadItemAsync<Family>(andersenFamily.Id, new PartitionKey(andersenFamily.LastName));
    Console.WriteLine("Item in database with id: {0} already exists\n", andersenFamilyResponse.Resource.Id);
}
catch(CosmosException ex) when (ex.StatusCode == HttpStatusCode.NotFound)
{
    // Create an item in the container representing the Andersen family. Note we provide the value of the partition key for this item, which is "Andersen"
    ItemResponse<Family> andersenFamilyResponse = await this.container.CreateItemAsync<Family>(andersenFamily, new PartitionKey(andersenFamily.LastName));

    // Note that after creating the item, we can access the body of the item with the Resource property off the ItemResponse. We can also access the RequestCharge property to see the amount of RUs consumed on this request.
    Console.WriteLine("Created item in database with id: {0} Operation consumed {1} RUs.\n", andersenFamilyResponse.Resource.Id, andersenFamilyResponse.RequestCharge);
}
}

項目に対してクエリを実行するQuery the items

項目を挿入した後、クエリを実行して "Andersen" ファミリの詳細を取得できます。After inserting an item, you can run a query to get the details of "Andersen" family. 次のコードは、SQL クエリを直接使用してクエリを実行する方法を示しています。The following code shows how to execute the query using the SQL query directly. "Anderson" ファミリの詳細を取得する SQL クエリは SELECT * FROM c WHERE c.LastName = 'Andersen' です。The SQL query to get the "Anderson" family details is: SELECT * FROM c WHERE c.LastName = 'Andersen'. program.cs クラス内で QueryItemsAsync メソッドを定義し、次のコードを追加します。Define the QueryItemsAsync method within the program.cs class and add the following code to it:

private async Task QueryItemsAsync()
{
    var sqlQueryText = "SELECT * FROM c WHERE c.LastName = 'Andersen'";

    Console.WriteLine("Running query: {0}\n", sqlQueryText);

    QueryDefinition queryDefinition = new QueryDefinition(sqlQueryText);
    FeedIterator<Family> queryResultSetIterator = this.container.GetItemQueryIterator<Family>(queryDefinition);

    List<Family> families = new List<Family>();

    while (queryResultSetIterator.HasMoreResults)
    {
        FeedResponse<Family> currentResultSet = await queryResultSetIterator.ReadNextAsync();
        foreach (Family family in currentResultSet)
        {
            families.Add(family);
            Console.WriteLine("\tRead {0}\n", family);
        }
    }
}

データベースを削除するDelete the database

最後に、次のコードを使用して DeleteDatabaseAndCleanupAsync メソッドを追加し、データベースを削除できます。Finally you can delete the database adding the DeleteDatabaseAndCleanupAsync method with the following code:

private async Task DeleteDatabaseAndCleanupAsync()
{
   DatabaseResponse databaseResourceResponse = await this.database.DeleteAsync();
   // Also valid: await this.cosmosClient.Databases["FamilyDatabase"].DeleteAsync();

   Console.WriteLine("Deleted Database: {0}\n", this.databaseId);

   //Dispose of CosmosClient
    this.cosmosClient.Dispose();
}

CRUD 操作を実行するExecute the CRUD operations

すべての必要なメソッドを定義したら、GetStartedDemoAsync メソッド内でそれらを実行します。After you have defined all the required methods, execute them with in the GetStartedDemoAsync method. メソッド DeleteDatabaseAndCleanupAsync は、メソッドが実行された場合にリソースが表示されないため、このコード内ではコメント アウトされています。The DeleteDatabaseAndCleanupAsync method commented out in this code because you will not see any resources if that method is executed. Azure portal で Azure Cosmos DB リソースが作成されたことを確認した後にコメントを解除できます。You can uncomment it after validating that your Azure Cosmos DB resources were created in the Azure portal.

public async Task GetStartedDemoAsync()
{
    // Create a new instance of the Cosmos Client
    this.cosmosClient = new CosmosClient(EndpointUrl, PrimaryKey);
    await this.CreateDatabaseAsync();
    await this.CreateContainerAsync();
    await this.AddItemsToContainerAsync();
    await this.QueryItemsAsync();
}

すべての必要なメソッドを追加したら、Program.cs ファイルを保存します。After you add all the required methods, save the Program.cs file.

コードの実行Run the code

次に、アプリケーションをビルドして実行し、Azure Cosmos DB リソースを作成します。Next build and run the application to create the Azure Cosmos DB resources. 新しいコマンド プロンプト ウィンドウを開き、環境変数の設定に使用したものと同じインスタンスを使用しないようにしてください。Make sure to open a new command prompt window, don't use the same instance that you have used to set the environment variables. 環境変数が現在開いているウィンドウで設定されていないためです。Because the environment variables are not set in the current open window. 更新内容を表示するには、新しいコマンド プロンプトを開く必要があります。You will need to open a new command prompt to see the updates.

dotnet build
dotnet run

アプリケーションを実行すると、次の出力が生成されます。The following output is generated when you run the application. また、Azure portal にサインインして、リソースが作成されたことを確認することもできます。You can also sign into the Azure portal and validate that the resources are created:

Created Database: FamilyDatabase

Created Container: FamilyContainer

Created item in database with id: Andersen.1 Operation consumed 11.62 RUs.

Running query: SELECT * FROM c WHERE c.LastName = 'Andersen'

        Read {"id":"Andersen.1","LastName":"Andersen","Parents":[{"FamilyName":null,"FirstName":"Thomas"},{"FamilyName":null,"FirstName":"Mary Kay"}],"Children":[{"FamilyName":null,"FirstName":"Henriette Thaulow","Gender":"female","Grade":5,"Pets":[{"GivenName":"Fluffy"}]}],"Address":{"State":"WA","County":"King","City":"Seattle"},"IsRegistered":false}

End of demo, press any key to exit.

データが作成されたことを確認するには、Azure portal にサインインし、Azure Cosmos アカウントで必要な項目を確認します。You can validate that the data is created by signing into the Azure portal and see the required items in your Azure Cosmos account.

リソースのクリーンアップClean up resources

必要がなくなったら、Azure CLI または Azure PowerShell を使用して、Azure Cosmos アカウントとそれに対応するリソース グループを削除できます。When no longer needed, you can use the Azure CLI or Azure PowerShell to remove the Azure Cosmos account and the corresponding resource group. 次のコマンドは、Azure CLI を使用してリソース グループを削除する方法を示しています。The following command shows how to delete the resource group by using the Azure CLI:

az group delete -g "myResourceGroup"

次の手順Next steps

このクイックスタートでは、Azure Cosmos アカウントを作成し、.NET Core アプリを使用してデータベースとコンテナーを作成する方法を説明しました。In this quickstart, you learned how to create an Azure Cosmos account, create a database and a container using a .NET Core app. これで、次の記事の指示に従って Azure Cosmos アカウントに追加のデータをインポートできるようになりました。You can now import additional data to your Azure Cosmos account with the instructions int the following article.