Compartilhar via

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

  • Artigo

APLICA-SE AO: Table

O script deste artigo cria uma conta e uma tabela do Azure Cosmos DB for Table 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 requer a CLI do Azure versão 2.12.1 ou mais recente.

    • 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 do Azure Cosmos DB for Table e uma tabela da API for Table com a funcionalidade 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 usa os seguintes comandos:

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

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

az group delete --name $resourceGroup

Próximas etapas