Partilhar via

Criar uma conta, banco de dados e contêiner do Azure Cosmos DB para NoSQL com dimensionamento automático

  • Artigo

APLICA-SE A: NoSQL

O script neste artigo cria uma conta, banco de dados e contêiner do Azure Cosmos DB para NoSQL com dimensionamento automático.

Pré-requisitos

  • Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

  • Este script requer a CLI do Azure versão 2.0.73 ou posterior.

    • Você pode executar o script no ambiente Bash no Azure Cloud Shell. Quando o Cloud Shell abrir, verifique se o Bash aparece no campo de ambiente no canto superior esquerdo da janela do shell. O Cloud Shell sempre tem a versão mais recente da CLI do Azure.

      O Cloud Shell é autenticado automaticamente na conta que você usou para entrar no portal do Azure. Você pode usar az account set para entrar com uma assinatura diferente, substituindo <subscriptionId> por sua ID de assinatura do Azure.

      subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

    • Se preferir, você pode instalar a CLI do Azure para executar o script localmente. Execute az version para localizar a versão da CLI do Azure e as bibliotecas dependentes instaladas e execute az upgrade se precisar atualizar. Se solicitado, instale as extensões da CLI do Azure. Se você estiver executando o Windows ou macOS, considere executar a CLI do Azure em um contêiner do Docker.

      Se você estiver usando uma instalação local, entre no Azure executando az login e seguindo os prompts. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

Script de exemplo

Execute o script a seguir para criar um grupo de recursos do Azure, uma conta e banco de dados do Azure Cosmos DB para NoSQL e um contêiner com dimensionamento automático. Os recursos podem demorar um pouco para serem criados.

# Create a SQL API database and container with autoscale

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-cosmosdb-rg-$randomIdentifier"
tag="autoscale-sql-cosmosdb"
account="msdocs-account-cosmos-$randomIdentifier" #needs to be lower case
database="msdocs-db-sql-cosmos"
container="container1"
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 SQL API
echo "Creating $account"
az cosmosdb create --name $account --resource-group $resourceGroup --default-consistency-level Eventual --locations regionName="$location" failoverPriority=0 isZoneRedundant=False

# Create a SQL API database
echo "Creating $database"
az cosmosdb sql database create --account-name $account --resource-group $resourceGroup --name $database

# Create a SQL API container with autoscale
echo "Creating $container with $maxThroughput"
az cosmosdb sql container create --account-name $account --resource-group $resourceGroup --database-name $database --name $container --partition-key-path $partitionKey --max-throughput $maxThroughput

Este script utiliza os seguintes comandos:

Clean up resources (Limpar recursos)

Se você não precisar mais dos recursos criados, use o comando az group delete para excluir o grupo de recursos e todos os recursos que ele contém. Esses recursos incluem a conta, o banco de dados e o contêiner do Azure Cosmos DB. Os recursos podem demorar um pouco para serem excluídos.

az group delete --name $resourceGroup

Próximos passos