Partage via

Créer un compte, une base de données et un conteneur Azure Cosmos DB for NoSQL avec mise à l’échelle automatique

  • Article

S’APPLIQUE À : NoSQL

Le script de cet article crée un compte, une base de données et un conteneur Azure Cosmos DB for NoSQL 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.0.73 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 et une base de données Azure Cosmos DB for NoSQL, et un conteneur avec mise à l’échelle automatique. Les ressources peuvent prendre un certain temps à créer.

# 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

Ce script utilise les commandes suivantes :

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, la base de données et le conteneur Azure Cosmos DB. Les ressources peuvent prendre un certain temps à supprimer.

az group delete --name $resourceGroup

Étapes suivantes