リソースを作成する

  • 4 分

Azure CLI を使用して Azure Cosmos DB for NoSQL アカウントを管理する場合、ほとんどのコマンドは、次の 2 つのコア CLI コマンド グループに分類されます。

  • az cosmosdb: このグループには、新しい Azure Cosmos DB アカウントの作成と管理に必要なコマンドが含まれています。
  • az cosmosdb sql: az cosmosdb グループのこのサブグループには、データベースやコンテナーなどの NoSQL API 固有のリソースを管理するためのコマンドが含まれています。

Azure Cosmos DB アカウント グループのコマンド

新しいアカウントを作成するには、 az cosmosdb create コマンドを使用する必要があります。 このコマンドを実行するには、少なくとも、作成する新しいアカウントの名前と、そのアカウント リソースのターゲット リソース グループが必要です。 新しいアカウントを作成するときは、名前が別のサービス インスタンスと競合してコマンドが失敗するのを防ぐために、使用する名前がグローバルに一意であることを確認する必要があります。

ヒント

既定では、このコマンドは新しい NoSQL アカウントを作成します。

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>'

新しいアカウントを作成するときに、必要に応じて追加のパラメーターを指定して、新しく作成されたアカウントの特性を制御することもできます。 たとえば、このコマンドは Free レベルを有効にし、既定の整合性レベルを [最終的] に設定します。

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --default-consistency-level 'Eventual' \
    --enable-free-tier 'true'

ほとんどの場合は、Azure Cosmos DB アカウントをデプロイするリージョンを指定します。 --locations 引数を使用して、アカウントの 1 つ以上のターゲットの場所を指定できます。

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --locations regionName='eastus'

後で、各場所に適切なフェールオーバーの優先度を設定するときに、複数のターゲットの場所を指定する方法を学習します。

注

不明な場合は、次の例の --help 引数 ( az cosmosdb --help & az cosmosdb create --help) を使用して、コマンドのヘルプ ドキュメントをいつでも参照できます。

Azure Cosmos DB for NoSQL サブグループのコマンド

az cosmosdb sql コマンド グループには、NoSQL API 内の個々のリソースを管理するための複数のコマンドとサブグループが含まれています。 たとえば、 az cosmosdb sql database create コマンドを使用して、既存のアカウント内に新しいデータベースを作成できます。 この例では、 --name 引数は新しいデータベースの名前を参照し、 --account-name 引数は前に作成したアカウントの名前を参照します。

az cosmosdb sql database create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --name '<database-name>'

az cosmosdb sql container create コマンドは、既存のデータベース内に新しいコンテナーを作成します。 このコンテキスト の --name 引数は新しいコンテナーの名前を参照し、 --database-name 引数は以前に作成したデータベースの名前を参照します。

この作成コマンドでは、Azure Cosmos DB for NoSQL のすべてのコンテナーに対してこの引数が必要であるため、少なくとも --partition-key-path 引数の値も必要です。

az cosmosdb sql container create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --database-name '<database-name>' \
    --name '<container-name>' \
    --throughput '400' \
    --partition-key-path '<partition-key-path-string>'

注

不明な場合は、次の例の --help 引数 ( az cosmosdb sql --help、 az cosmosdb sql database --help、 az cosmosdb sql container --help) を使用して、コマンドのヘルプ ドキュメントをいつでも参照できます。