Utiliser l’Explorateur Azure Cosmos DB pour gérer vos données

  • Article

S’APPLIQUE À : NoSQL MongoDB Cassandra Gremlin Table

L’explorateur Azure Cosmos DB est une interface web autonome qui vous permet de voir et de gérer les données stockées dans Azure Cosmos DB. L’Explorateur Azure Cosmos DB est l’équivalent de la section Explorateur de données existante, disponible dans le portail Azure, pour les comptes Azure Cosmos DB.

L’Explorateur Azure Cosmos DB présente quelques avantages notables par rapport à l’Explorateur de données, notamment :

  • Affichage en mode plein écran pour parcourir les données, exécuter des requêtes et observer leurs résultats
  • Possibilité de fournir aux utilisateurs sans accès au portail Azure ni abonnement Azure des fonctionnalités de lecture ou de lecture-écriture sur des données situées dans des conteneurs
  • Possibilité de partager des résultats de requête avec des utilisateurs qui n’ont pas d’abonnement Azure ni d’accès au portail Azure

Prérequis

Accéder directement à l’Explorateur à l’aide de votre abonnement Azure

Vous pouvez accéder directement à l’Explorateur et utiliser vos informations d’identification existantes pour démarrer rapidement avec l’outil.

  1. Accédez à https://cosmos.azure.com.

  2. Sélectionnez Connexion. Connectez-vous à l’aide de vos informations d’identification existantes qui vous permettent d’accéder à votre compte Azure Cosmos DB.

  3. Ensuite, sélectionnez votre abonnement Azure et votre compte cible dans le menu Sélectionner un compte de base de données.

    Screenshot of the 'Select a Database Account' menu in the Explorer.

Accéder à l’Explorateur à partir du portail Azure à l’aide de votre abonnement Azure

Si vous êtes déjà à l’aise avec le portail Azure, vous pouvez naviguer directement depuis l’Explorateur de données intégré au portail vers l’Explorateur autonome.

  1. Connectez-vous au portail Azure.

  2. Accédez à votre compte Azure Cosmos DB existant.

  3. Dans le menu de la ressource, sélectionnez Explorateur de données.

  4. Ensuite, sélectionnez l’option de menu Ouvrir en mode plein écran.

    Screenshot of the Data Explorer page with the 'Open Full Screen' option highlighted.

  5. Dans la boîte de dialogue Ouvrir en mode plein écran, sélectionnez Ouvrir.

Octroyer à une autre personne l’accès à l’Explorateur à l’aide d’une chaîne de connexion

Utilisez la clé en lecture-écriture ou en lecture seule pour octroyer à un autre utilisateur l’accès à votre compte Azure Cosmos DB. Cette méthode fonctionne même si l’utilisateur n’a pas accès à un abonnement Azure ni au portail Azure.

  1. Connectez-vous au portail Azure.

  2. Accédez à votre compte Azure Cosmos DB existant.

  3. Dans le menu des ressources, sélectionnez Clés.

  4. Dans la page Clés, sélectionnez l’option Clés en lecture-écriture ou Clés en lecture seule. Ensuite, copiez la valeur du champ Chaîne de connexion principale. Vous utiliserez cette valeur ultérieurement.

    Description
    Clé en lecture-écriture Fournit un accès permettant d’afficher et de modifier les bases de données, conteneurs, requêtes et autres ressources associées à ce compte spécifique.
    Clé en lecture seule Fournit un accès permettant d’afficher les bases de données, conteneurs, requêtes et autres ressources associées à ce compte spécifique.

    Conseil

    Si vous voulez partager les résultats d’une requête avec vos collègues qui n’ont pas accès à un abonnement Azure ni au portail Azure, vous pouvez leur fournir un accès en lecture seule.

  5. À présent, demandez à l’autre utilisateur d’accéder à https://cosmos.azure.com.

  6. Sélectionnez Connecter à votre compte avec la chaîne de connexion. Ensuite, demandez à l’utilisateur d’entrer la chaîne de connexion copiée précédemment et de sélectionner Connexion.

Configurer le seuil des unités de requête

Dans l’Explorateur, vous pouvez configurer une limite pour les unités de requête par seconde (RU/s) que les requêtes utilisent. Utilisez cette fonctionnalité pour contrôler le coût et les performances dans les unités de requête (RU) de vos requêtes. Cette fonctionnalité permet également d’annuler automatiquement les requêtes à coût élevé.

  1. Démarrez l’Explorateur dans le compte Azure Cosmos DB cible.

  2. Sélectionnez l’option de menu Paramètres.

    Screenshot of an Data Explorer page with the 'Open Settings' option highlighted.

  3. Dans la boîte de dialogue Paramètres, déterminez si vous voulez activer le seuil des RU, ainsi que la valeur du seuil des RU réelle.

    Screenshot of the individual settings to configure the request unit threshold

    Conseil

    Le seuil des RU est automatiquement activé avec une valeur par défaut de 5 000  RU.

Problèmes connus

Les problèmes actuellement connus sont les suivants :

  • L’Explorateur de données ne prend pas en charge la navigation dans des éléments qui contiennent un UUID. Cette limite n’affecte pas le chargement des conteneurs, mais uniquement l’affichage des éléments individuels ou des requêtes qui incluent ces éléments. Pour afficher et gérer ces éléments, les utilisateurs doivent continuer à utiliser les mêmes outils/SDK initialement utilisés pour les créer.

  • Des erreurs HTTP 401 peuvent se produire en raison d’autorisations de contrôle d’accès en fonction du rôle insuffisantes pour votre compte Microsoft Entra ID. Cette condition peut être vraie, notamment si le compte a un rôle personnalisé. Tous les rôles personnalisés doivent avoir l’action Microsoft.DocumentDB/databaseAccounts/listKeys/* incluse pour utiliser l’Explorateur.

Étape suivante

Getting started with queries (Prise en main des requêtes)