Démarrage rapide : créer un compte, une base de données, un conteneur et des éléments Azure Cosmos DB à partir du portail Azure

Article
03/09/2023

S’APPLIQUE À : NoSQL

Azure Cosmos DB est le service de base de données multi-modèle de Microsoft distribué à l’échelle mondiale. Vous pouvez utiliser Azure Cosmos DB pour créer et interroger rapidement des bases de données de clés/valeurs, de documents et de graphes. Cette approche bénéficie des fonctionnalités de distribution mondiale et de mise à l’échelle horizontale au cœur d’Azure Cosmos DB.

Ce guide de démarrage rapide montre comment utiliser le portail Azure pour créer un compte Azure Cosmos DB d’API pour NoSQL. Dans ce compte, vous créez une base de données de documents et un conteneur, puis ajoutez des données au conteneur. Sans carte de crédit ou abonnement Azure, vous pouvez configurer un compte d’essai Azure Cosmos DB gratuit.

Prérequis

Un abonnement Azure ou un compte d’essai gratuit Azure Cosmos DB.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
Vous pouvez essayer Azure Cosmos DB gratuitement sans abonnement Azure, et sans engagement requis. Vous pouvez également créer un compte de niveau gratuit Azure Cosmos DB qui propose gratuitement 1000 RU et 25 Go de stockage. Vous pouvez également utiliser l’émulateur Azure Cosmos DB avec l’URI https://localhost:8081. Pour obtenir la clé à utiliser avec l’émulateur, consultez Authentification des demandes.

Création d’un compte Azure Cosmos DB

Dans le menu du portail Azure ou dans la page d’accueil, sélectionnez Créer une ressource.
Rechercher Azure Cosmos DB. Sélectionnez Créer>Azure Cosmos DB.
Dans la page Création d’un compte Azure Cosmos DB, sélectionnez l’option Créer dans la section Azure Cosmos DB for NoSQL.

Azure Cosmos DB fournit plusieurs API :
- NoSQL, pour des données de document
- PostgreSQL
- MongoDB, pour des données de document
- Apache Cassandra
- Table de charge de travail
- Apache Gremlin, pour des données graphiques
Pour en savoir plus sur l’API pour NoSQL, consultez Bienvenue dans Azure Cosmos DB.

Sur la page Créer un compte Azure Cosmos DB, entrez les paramètres de base du nouveau compte Azure Cosmos DB.

Paramètre	valeur	Description
Abonnement	Nom d’abonnement	Sélectionnez l’abonnement Azure que vous souhaitez 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. Étant donné que documents.azure.com est ajouté au nom que vous fournissez pour créer votre URI, utilisez un nom unique. Le nom ne peut contenir que des lettres minuscules, des chiffres et le caractère trait d’union (-). Il 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 1000 RU/s et 25 Go de stockage dans un compte. Découvrez-en plus sur le niveau gratuit.
Limiter le débit total du compte	Sélectionné ou non	Limiter la quantité totale de débit pouvant être approvisionné sur ce compte. Cette limite empêche les frais inattendus liés au débit approvisionné. Vous pouvez mettre à jour ou supprimer cette limite une fois votre compte créé.

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.

Remarque

Les options suivantes ne sont pas disponibles si vous sélectionnez Serverless comme Mode de capacité :

Appliquer la remise de niveau gratuit
Limiter le débit total du compte

Sous l’onglet Distribution globale, configurez les informations suivantes. Pour ce démarrage rapide, vous pouvez conserver les valeurs par défaut :

Paramètre	valeur	Description
Géoredondance	Désactiver	Activez ou désactivez la diffusion mondiale sur votre compte en appairant votre région avec une région correspondante. Vous pourrez ajouter d’autres régions à votre compte ultérieurement.
Écritures multirégions	Désactiver	La fonctionnalité d’écritures multirégions vous permet de tirer parti du débit provisionné pour vos bases de données et conteneurs à travers le monde.
Zones de disponibilité	Désactiver	Les zones de disponibilité vous permettent d’accroître la disponibilité et d’améliorer la résilience de votre application.

Notes

Les options suivantes ne sont pas disponibles si vous sélectionnez Serverless comme Mode de capacité sur la page Informations de base précédente :

Géo-redondance
Écritures multirégions

Si vous le souhaitez, vous pouvez configurer des informations supplémentaires sous les onglets suivants :
- Mise en réseau. Configurez l’accès à partir d’un réseau virtuel.
- Stratégie de sauvegarde. Configurez une stratégie de sauvegarde périodique ou continue.
- Chiffrement. Utilisez une clé gérée par le service ou une clé gérée par le client.
- Tags (balises). Les étiquettes sont des paires nom/valeur qui vous permettent de catégoriser les ressources et d’afficher une facturation centralisée en appliquant la même étiquette à plusieurs ressources et groupes de ressources.
Sélectionnez Revoir + créer.
Passez en revue les paramètres du compte, 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é.
Sélectionnez Accéder à la ressource pour accéder à la page du compte Azure Cosmos DB.

Ajouter une base de données et un conteneur

Vous pouvez utiliser l’Explorateur de données du portail Azure pour créer une base de données et un conteneur.

Dans la page de votre compte Azure Cosmos DB, sur la gauche, sélectionnez Explorateur de données, puis Nouveau conteneur>New Container.

Vous devrez peut-être faire défiler vers la droite pour voir la fenêtre Nouveau conteneur.

Dans le volet Nouveau conteneur, entrez les paramètres du nouveau conteneur.

Paramètre	Valeur suggérée	Description
ID de base de données	ToDoList	Entrez ToDoList pour le nom de la nouvelle base de données. Les noms de base de données doivent comporter de 1 à 255 caractères, et ne peuvent pas contenir`/`, `\`, `#`, `?`, ni un espace de fin. Vérifiez l’option Partager le débit entre les conteneurs. Elle vous permet de partager le débit approvisionné sur la base de données entre tous les conteneurs au sein de la base de données. Cette option permet également de réduire les coûts.
Débit de la base de données	Mise à l’échelle automatique ou Manuel	Le débit Manuel vous permet de mettre à l’échelle vous-même des unités de requête par seconde (RU/s), tandis que le débit Mise à l’échelle automatique permet au système de mettre à l’échelle les RU/s en fonction de l’utilisation. Sélectionnez Manuel pour cet exemple.
Nombre maximal de RU/s de base de données	400 RU/s	Si vous voulez réduire la latence, vous pouvez effectuer un scale-up du débit plus tard en estimant les RU/s avec la calculatrice de capacité. Remarque : ce paramètre n’est pas disponible lors de la création d’un nouveau conteneur dans un compte serverless.
ID de conteneur	Éléments	Entrez Éléments comme nom de votre nouveau conteneur. Les ID de conteneur sont soumis aux mêmes exigences en termes de caractères que les noms de base de données.
Clé de partition	/category	L’exemple décrit dans cet article utilise /category comme clé de partition.

Pour cet exemple, n’ajoutez pas de clés uniques et n’activez pas le Magasin analytique.

Les clés uniques vous permettent d’ajouter une couche d’intégrité des données à la base de données en garantissant que chaque clé de partition contient des valeurs uniques. Pour plus d’informations, consultez Clés uniques dans Azure Cosmos DB.
Le Stockage analytique permet d’effectuer des analyses à grande échelle de données opérationnelles sans aucun impact sur vos charges de travail transactionnelles.

Sélectionnez OK. L’Explorateur de données présente la nouvelle base de données et le conteneur que vous avez créé.

Ajouter des données à votre base de données

Ajoutez des données à votre nouvelle base de données à l’aide de l’Explorateur de données.

Dans l’Explorateur de données, développez la base de données ToDoList, puis développez le conteneur Éléments.
Ensuite, sélectionnez Éléments, puis sélectionnez Nouvel élément.

Ajoutez la structure suivante au document, sur la droite du volet Documents :

{
    "id": "1",
    "category": "personal",
    "name": "groceries",
    "description": "Pick up apples and strawberries.",
    "isComplete": false
}

Cliquez sur Enregistrer.
Sélectionnez à nouveau Nouvel élément, puis créez et enregistrez un autre document avec un id unique, ainsi que les propriétés et valeurs souhaitées. Vos documents peuvent avoir la structure de votre choix, car Azure Cosmos DB n’impose aucun schéma à vos données.

Interroger vos données

Vous pouvez utiliser des requêtes dans l’Explorateur de données pour récupérer et filtrer vos données.

Dans l’Explorateur de données, en haut de l’onglet Éléments, examinez la requête par défaut SELECT * FROM c. Cette requête récupère et affiche tous les documents du conteneur, classés par ID.
Pour modifier la requête, sélectionnez Modifier le filtre, remplacez la requête par défaut par ORDER BY c._ts DESC, puis sélectionnez Appliquer le filtre.

Cette requête modifiée affiche les documents dans l’ordre décroissant en fonction de leur timestamp. Votre deuxième document s’affiche désormais en tête de liste.

Si vous êtes à l’aise avec la syntaxe SQL, vous pouvez saisir n’importe quelle requête SQL prise en charge dans la zone du prédicat de requête. Vous pouvez également utiliser l’Explorateur de données pour créer des procédures stockées, des fonctions définies par l’utilisateur et des déclencheurs utilisés côté serveur par la logique métier.

L’Explorateur de données permet d’accéder facilement depuis le portail Azure à toutes les fonctionnalités intégrées d’accès aux données programmatiques qui sont disponibles dans les API. Vous pouvez également utiliser le portail Azure pour mettre à l’échelle le débit, obtenir des clés et des chaînes de connexion, et passer en revue les indicateurs de performance et les contrats de niveau de service de votre compte Azure Cosmos DB.

Nettoyer les ressources

Quand vous en avez terminé avec votre application et votre compte Azure Cosmos DB, vous pouvez supprimer les ressources Azure que vous avez créées afin d’éviter des frais supplémentaires. Pour supprimer les ressources :

Depuis la barre de recherche du portail Azure, recherchez et sélectionnez Groupes de ressources.
Dans la liste, sélectionnez le groupe de ressources créé pour ce guide de démarrage rapide.
Dans la page Vue d’ensemble du groupe de ressources, sélectionnez Supprimer un groupe de ressources.
Dans la fenêtre suivante, entrez le nom du groupe de ressources à supprimer, puis sélectionnez Supprimer.

Si vous souhaitez supprimer uniquement la base de données et utiliser le compte Azure Cosmos DB à l’avenir, vous pouvez supprimer la base de données en effectuant les étapes suivantes :

Accédez à votre compte Azure Cosmos DB.
Ouvrez l’Explorateur de données, sélectionnez Plus (...) sur la base de données que vous souhaitez supprimer et sélectionnez Supprimer la de base de données.
Entrez l’ID ou le nom de la base de données pour confirmer l’opération de suppression.

Étapes suivantes

Vous pouvez maintenant importer plus de données dans votre compte Azure Cosmos DB.