Usar a CLI do Azure para criar uma conta e uma tabela do Azure Cosmos DB para tabela com dimensionamento automático

  • Artigo

APLICA-SE A: Tabela

O script neste artigo cria uma conta do Azure Cosmos DB para tabela e uma tabela 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.12.1 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 do Azure Cosmos DB para Tabela e uma tabela API para Tabela com capacidade de dimensionamento automático. Os recursos podem demorar um pouco para serem criados.

# Create a Table API table with autoscale

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

# Create a Table API Table with autoscale
echo "Create $table with $maxThroughput"
az cosmosdb table create --account-name $account --resource-group $resourceGroup --name $table --max-throughput $maxThroughput

Este script utiliza os seguintes comandos:

  • az group create cria um grupo de recursos para armazenar todos os recursos.
  • az cosmosdb create with --capabilities EnableTable cria uma conta do Azure Cosmos DB para API for Table.
  • az cosmosdb table create with --max-throughput 1000 cria uma tabela do Azure Cosmos DB for Table com recursos de dimensionamento automático.

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 e a tabela do Azure Cosmos DB. Os recursos podem demorar um pouco para serem excluídos.

az group delete --name $resourceGroup

Próximos passos