Créer un compte Azure Cosmos DB for NoSQL

S’APPLIQUE À : NoSQL

Un compte Azure Cosmos DB for NoSQL contient toutes vos ressources Azure Cosmos DB : bases de données, conteneurs et éléments. Le compte fournit un point de terminaison unique pour différents outils et kits SDK pour se connecter à Azure Cosmos DB et effectuer des opérations quotidiennes. Pour plus d’informations sur les ressources dans Azure Cosmos DB, consultez le modèle de ressource Azure Cosmos DB.

Prérequis

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.

Créer un compte

Créez un seul compte Azure Cosmos DB à l’aide de l’API pour NoSQL.

Azure CLI

1. Créez des variables d’interpréteur de commandes pour accountName, resourceGroupName et location.

   # Variable for resource group name
   resourceGroupName="msdocs-cosmos"
   
   # Variable for location
   location="westus"
   
   # Variable for account name with a randomnly generated suffix
   let suffix=$RANDOM*$RANDOM
   accountName="msdocs-$suffix"
   

2. Si vous ne l’avez pas déjà fait, connectez-vous à Azure CLI à l’aide de la commande az login.

3. Utilisez la commande az group create pour créer un groupe de ressources dans votre abonnement.

   az group create \
       --name $resourceGroupName \
       --location $location
   

4. Utilisez la commande az cosmosdb create pour créer un compte Azure Cosmos DB for NoSQL avec les paramètres par défaut.

   az cosmosdb create \
       --resource-group $resourceGroupName \
       --name $accountName \
       --locations regionName=$location
   

PowerShell

1. Créez des variables d’interpréteur de commandes pour ACCOUNT_NAME, RESOURCE_GROUP_NAME et LOCATION.

   # Variable for resource group name
   $RESOURCE_GROUP_NAME = "msdocs-cosmos"
   
   # Variable for location
   $LOCATION = "West US"
   
   # Variable for account name with a randomnly generated suffix
   $SUFFIX = Get-Random
   $ACCOUNT_NAME = "msdocs-$SUFFIX"
   

2. Si vous ne l’avez pas déjà fait, connectez-vous à Azure PowerShell à l’aide de l’applet du cmdlet Connect-AzAccount.

3. Utilisez le cmdlet New-AzResourceGroup pour créer un groupe de ressources dans votre abonnement.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters    
   

4. Utilisez le cmdlet New-AzCosmosDBAccount pour créer un compte Azure Cosmos DB for NoSQL avec les paramètres par défaut.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       Location = $LOCATION
   }
   New-AzCosmosDBAccount @parameters
   

Portail

Conseil

Pour ce guide, nous vous recommandons d’utiliser le nom du groupe de ressources msdocs-cosmos.

1. Connectez-vous au portail Azure.

2. Dans le menu du portail Azure ou dans la page d’accueil, sélectionnez Créer une ressource.

3. Dans la page Nouveau, recherchez et sélectionnez Azure Cosmos DB.

4. Dans la page Sélectionner l’option API, sélectionnez l’option Créer dans la section NoSQL - Recommander. Azure Cosmos DB a cinq API : SQL, MongoDB, Gremlin, Table et Cassandra. Apprenez-en davantage sur l’API pour NoSQL.

   

5. Dans la page Créer un compte Azure Cosmos DB, entrez les informations suivantes :

   Paramètre	valeur	Description
   Abonnement	Nom d’abonnement	Sélectionnez l’abonnement Azure à utiliser pour ce compte Azure Cosmos DB.
   Groupe de ressources	Nom de groupe ressources	Sélectionnez un groupe de ressources ou sélectionnez Créer, puis entrez un nom unique pour le nouveau groupe de ressources.
   Nom du compte	Un nom unique	Entrez un nom pour identifier votre compte Azure Cosmos DB. Le nom sera utilisé dans le cadre d’un nom de domaine complet (FQDN) avec un suffixe de documents.azure.com, pour que le nom soit unique. Le nom peut uniquement contenir des lettres minuscules, des chiffres et le caractère de trait d’union (-). Le nom doit comporter entre 3 et 44 caractères.
   Emplacement	La région la plus proche de vos utilisateurs	Sélectionnez la zone géographique dans laquelle héberger votre compte Azure Cosmos DB. Utilisez l’emplacement le plus proche de vos utilisateurs pour leur donner l’accès le plus rapide possible aux données.
   Mode de capacité	Débit approvisionné ou serverless	Sélectionnez Débit approvisionné pour créer un compte dans mode de débit approvisionné. Sélectionnez serverless pour créer un compte en mode serverless.
   Appliquer la remise de niveau gratuit Azure Cosmos DB	Appliquer ou Ne pas appliquer	Avec le niveau gratuit d’Azure Cosmos DB, vous recevez gratuitement 1 000 RU/s et 25 Go de stockage dans un compte. Découvrez-en plus sur le niveau gratuit.

   Notes

   Vous pouvez avoir un seul compte Azure Cosmos DB de niveau gratuit par abonnement Azure et vous devez vous inscrire lors de la création du compte. Si vous ne voyez pas l’option permettant d’appliquer la remise de niveau gratuit, cela signifie qu’un autre compte dans l’abonnement a déjà été activé avec le niveau gratuit.

   

6. Sélectionnez Revoir + créer.

7. Passez en revue les paramètres que vous fournissez, puis sélectionnez Créer. La création du compte prend quelques minutes. Attendez que la page du portail affiche Votre déploiement est terminé.

8. Sélectionnez Accéder à la ressource pour accéder à la page du compte Azure Cosmos DB.

   

Étapes suivantes

Dans ce guide, vous avez appris à créer un compte Azure Cosmos DB for NoSQL. Vous pouvez maintenant créer une application avec votre compte Azure Cosmos DB.

Créer une application console .NET avec Azure Cosmos DB for NoSQL