Azure CLI を使って、Gremlin 用 API アカウント、データベース、自動スケーリングするグラフを作成する

適用対象: Gremlin

この記事のスクリプトでは、Azure Cosmos DB for Gremlin アカウント、データベース、自動スケーリングするグラフが作成されます。

前提条件

  • Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

  • このスクリプトでは、Azure CLI バージョン 2.30 以降が必要となります。

    • このスクリプトは、Azure Cloud Shell の Bash 環境で実行できます。 Cloud Shell が開いたら、シェル ウィンドウの左上にある環境フィールドで Bash を選択してください。 Cloud Shell には Azure CLI の最新バージョンがあります。

    • 必要に応じて、Azure CLI をインストールしてスクリプトをローカルで実行できます。 az version を実行して Azure CLI のバージョンを確認し、アップグレードする必要がある場合は az upgrade を実行します。 az login を実行して Azure にサインインします。

サンプル スクリプト

このスクリプトでは以下のコマンドを使用します。

  • az group create: すべてのリソースを格納するリソース グループが作成されます。
  • az cosmosdb create (--capabilities EnableGremlin パラメーターを指定): Gremlin 対応の Azure Cosmos DB アカウントが作成されます。
  • az cosmosdb gremlin database create: Azure Cosmos DB for Gremlin のデータベースが作成されます。
  • az cosmosdb gremlin graph create (--max-throughput パラメーターに最小の 4000 を指定): 自動スケーリングする Azure Cosmos DB for Gremlin のグラフが作成されます。
# Create a Gremlin API database and graph with autoscale

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-cosmosdb-rg-$randomIdentifier"
tag="autoscale-gremlin-cosmosdb"
account="msdocs-account-cosmos-$randomIdentifier" #needs to be lower case
database="msdocs-db-gremlin-cosmos"
graph="msdocs-graph1-gremlin-cosmos"
partitionKey="/partitionKey"
maxThroughput=1000 #minimum = 1000

# Create a resource group
echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag

# Create a Cosmos account for Gremlin API
echo "Creating $account"
az cosmosdb create --name $account --resource-group $resourceGroup --capabilities EnableGremlin --default-consistency-level Eventual --locations regionName="$location" failoverPriority=0 isZoneRedundant=False

# Create a Gremlin database
echo "Creating $database with $account"
az cosmosdb gremlin database create --account-name $account --resource-group $resourceGroup --name $database

# Create a Gremlin graph with autoscale
echo "Creating $graph"
az cosmosdb gremlin graph create --account-name $account --resource-group $resourceGroup --database-name $database --name $graph --partition-key-path $partitionKey --max-throughput $maxThroughput

リソースを削除する

スクリプトで作成されたリソースが必要ない場合は、az group delete コマンドを使用して、リソース グループとそれに含まれるすべてのリソース (Azure Cosmos DB アカウントとデータベースを含む) を削除します。

az group delete --name $resourceGroup

次の手順

Azure Cosmos DB CLI のドキュメント