Créer des ressources

  • 4 minutes

Lors de la gestion de comptes Azure Cosmos DB for NoSQL avec l’interface Azure CLI, la plupart des commandes sont décomposées en deux groupes de commandes CLI principaux :

  • az cosmosdb : ce groupe contient les commandes requises pour créer et gérer un compte Azure Cosmos DB.
  • az cosmosdb sql : ce sous-groupe du groupe az cosmosdb contient les commandes permettant de gérer des ressources spécifiques à l’API NoSQL, telles que des bases de données et des conteneurs.

Commandes de groupe de comptes Azure Cosmos DB

Pour créer un compte, vous devez utiliser la commande az cosmosdb create . Cette commande requiert au minimum le nom du nouveau compte à créer et le groupe de ressources cible pour la ressource de compte. Lors de la création du nouveau compte, vous devez vous assurer que le nom que vous utilisez est globalement unique, afin d’éviter que la commande échoue en raison d’un conflit de noms avec une autre instance de service.

Conseil

Par défaut, cette commande crée un compte NoSQL.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>'

Lorsque vous créez un nouveau compte, vous pouvez également spécifier des paramètres supplémentaires pour contrôler les caractéristiques du compte nouvellement créé. Par exemple, cette commande active le niveau gratuit et définit le niveau de cohérence par défaut sur Final.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --default-consistency-level 'Eventual' \
    --enable-free-tier 'true'

Dans la plupart des cas, vous devez spécifier la région dans laquelle vous souhaitez déployer votre compte Azure Cosmos DB. Vous pouvez utiliser l’argument --locations pour spécifier un ou plusieurs emplacements cibles pour votre compte.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --locations regionName='eastus'

Plus tard, vous apprendrez à spécifier plusieurs emplacements cibles lors de la définition des priorités de basculement appropriées pour chaque emplacement.

Remarque

En cas de doute, vous pouvez toujours rechercher la documentation d’aide pour les commandes à l’aide de l’argument --help dans ces exemples : az cosmosdb --help & az cosmosdb create --help.

Commandes du sous-groupe Azure Cosmos DB for NoSQL

Le groupe de commandes sql az cosmosdb contient plusieurs commandes et sous-groupes pour gérer des ressources individuelles dans l’API NoSQL. Par exemple, vous pouvez utiliser la commande az cosmosdb sql database create pour créer une base de données dans un compte existant. Dans cet exemple, l’argument --name fait référence au nom de la nouvelle base de données, et l’argument --account-name fait référence au nom du compte créé précédemment.

az cosmosdb sql database create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --name '<database-name>'

La commande az cosmosdb sql container create crée un conteneur au sein d’une base de données existante. L’argument --name dans ce contexte fait référence au nom du nouveau conteneur, tandis que l’argument --database-name fait référence au nom de la base de données créée précédemment.

Cette commande de création nécessite également, au minimum, une valeur pour l’argument --partition-key-path , car cet argument est requis pour tous les conteneurs dans Azure Cosmos DB pour NoSQL.

az cosmosdb sql container create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --database-name '<database-name>' \
    --name '<container-name>' \
    --throughput '400' \
    --partition-key-path '<partition-key-path-string>'

Remarque

En cas de doute, vous pouvez toujours rechercher la documentation d’aide pour les commandes à l’aide de l’argument --help dans ces exemples : az cosmosdb sql --help, az cosmosdb sql database --help, & az cosmosdb sql container --help.