Partager via

Utiliser Azure CLI pour créer un compte et une table Azure Cosmos DB for Table avec mise à l’échelle automatique

  • Article

S’APPLIQUE À : Table

Le script de cet article crée un compte et une table Azure Cosmos DB for Table avec mise à l’échelle automatique.

Prérequis

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

  • Ce script requiert Azure CLI version 2.12.1 ou ultérieure.

    • Vous pouvez exécuter le script dans l’environnement Bash dans Azure Cloud Shell. Lorsque Cloud Shell s’ouvre, assurez-vous que Bash figure dans le champ d’environnement en haut à gauche de la fenêtre du shell. Cloud Shell dispose toujours de la dernière version d'Azure CLI.

      Cloud Shell est authentifié automatiquement sous le compte avec lequel vous aviez l’habitude de vous connecter au Portail Azure. Vous pouvez utiliser az account set pour vous connecter avec un autre abonnement, en remplaçant <subscriptionId> par votre ID d’abonnement Azure.

      subscription="<subscriptionId>" # add subscription here

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

    • Si vous préférez, vous pouvez installer Azure CLI pour exécuter le script localement. Exécutez az version pour rechercher votre version d’Azure CLI et les bibliothèques dépendantes installées, et exécutez az upgrade si vous devez effectuer une mise à niveau. Si vous y êtes invité, installez les extensions Azure CLI. Si vous exécutez Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker.

      Si vous utilisez une installation locale, connectez-vous à Azure à l’aide de la commande az login et suivez les invites. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.

Exemple de script

Exécutez le script suivant pour créer un groupe de ressources Azure, un compte Azure Cosmos DB for Table et une table API pour Table avec fonctionnalité de mise à l’échelle automatique. Les ressources peuvent prendre un certain temps à créer.

# 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

Ce script utilise les commandes suivantes :

  • az group create crée un groupe de ressources pour stocker toutes les ressources.
  • az cosmosdb create avec --capabilities EnableTable crée un compte Azure Cosmos DB pour l’API pour Table.
  • az cosmosdb table create avec --max-throughput 1000 crée une table Azure Cosmos DB for Table avec des fonctionnalités de mise à l’échelle automatique.

Nettoyer les ressources

Si vous n’avez plus besoin des ressources que vous avez créées, utilisez la commande az group delete pour supprimer le groupe de ressources et toutes les ressources qu’il contient. Ces ressources incluent le compte et la table Azure Cosmos DB. Les ressources peuvent prendre un certain temps à supprimer.

az group delete --name $resourceGroup

Étapes suivantes