Compartilhar via

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

  • Artigo

APLICA-SE A: NoSQL

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

Pré-requisitos

  • Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

  • Este script exige 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 for aberto, verifique se Bash é exibido no campo do ambiente no canto superior esquerdo da janela do shell. O Cloud Shell sempre tem a última versão da CLI do Azure.

      O Cloud Shell é automaticamente autenticado na conta que você usou para entrar no portal do Azure. Use az account set para entrar com outra assinatura, substituindo <subscriptionId> pela sua ID da assinatura do Azure.

      subscription="<subscriptionId>" # add subscription here

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

    • Se preferir, instale a CLI do Azure para executar o script localmente. Execute az version para encontrar a versão da CLI do Azure e as bibliotecas dependentes instaladas e execute az upgrade se precisar atualizá-la. Se solicitado, instale as extensões da CLI do Azure. Se estiver executando o Windows ou o macOS, considere a possibilidade de executar a CLI do Azure em um contêiner do Docker.

      Se estiver usando uma instalação local, entre no Azure executando az login e seguindo os avisos. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

Exemplo de script

Execute o script a seguir para criar um grupo de recursos do Azure, uma conta e um banco de dados do Azure Cosmos DB for 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 usa os seguintes comandos:

Limpar os recursos

Caso não precise 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óximas etapas