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

S’APPLIQUE À : NoSQL MongoDB Cassandra Gremlin Table

L’explorateur de données Azure Cosmos DB est une interface web qui vous permet de voir et de gérer les données stockées dans Azure Cosmos DB.

L’Explorateur de données Azure Cosmos DB dédié (https://cosmos.azure.com) présente quelques avantages clés par rapport à l’expérience de l’Explorateur de données du portail Microsoft Azure, 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

• Compte Azure Cosmos DB existant.
  • Si vous n’avez pas d’abonnement Azure, essayez gratuitement Azure Cosmos DB.

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

Vous pouvez accéder directement à l’Explorateur de données 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.

   

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

Si vous êtes déjà à l’aise avec le portail Microsoft Azure, vous pouvez naviguer directement depuis l’Explorateur de données intégré au portail vers l’Explorateur de données 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.

   

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

Personnaliser vos vues de données avec le sélecteur de colonnes personnalisées

Le sélecteur de colonnes personnalisées dans l’Explorateur de données Azure Cosmos DB vous permet de personnaliser vos vues de données en sélectionnant des colonnes spécifiques qui sont les plus pertinentes pour votre analyse lors de l’utilisation de l’API NoSQL. Auparavant, dans la vue d’éléments de l’Explorateur de données, vous ne pouviez voir que les colonnes de clé de partition et d’ID. Maintenant, avec cette nouvelle fonctionnalité, vous pouvez sélectionner une ou plusieurs propriétés à partir de votre document, et créer des colonnes supplémentaires pour visualiser facilement vos données. 

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, (facultatif) sélectionnez l’option de menu Ouvrir en mode plein écran.

   

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

6. Une fois dans l’Explorateur de données, ouvrez la collection à interroger et sélectionnez Éléments.

7. Cliquez sur le menu des points de suspension en haut à droite de n’importe quelle colonne et sélectionnez Modifier la colonne.

8. Sélectionnez les colonnes que vous souhaitez afficher et enregistrez vos paramètres.

9. La vue des données reflète désormais uniquement les colonnes sélectionnées, ce qui facilite le focus sur les données pertinentes.

10. Supprimer une colonne personnalisée

11. Une fois dans l’Explorateur de données, ouvrez la collection à interroger et sélectionnez Éléments.

12. Cliquez sur le menu des points de suspension en haut à droite de n’importe quelle colonne et sélectionnez Supprimer la colonne.

13. Trier les colonnes par ordre croissant ou décroissant

14. Une fois dans l’Explorateur de données, ouvrez la collection à interroger et sélectionnez Éléments.

15. Cliquez sur le menu des points de suspension en haut à droite de n’importe quelle colonne et sélectionnez Supprimer la colonne.

16. Réinitialiser l’affichage des colonnes

17. Une fois dans l’Explorateur de données, ouvrez la collection à interroger et sélectionnez Éléments.

18. Cliquez sur le menu des points de suspension en haut à droite de n’importe quelle colonne et sélectionnez Modifier la colonne.

19. Sélectionnez Réinitialiser pour revenir à la vue par défaut. Vous pouvez également effacer vos paramètres d’historique des filtres, de colonnes et de fenêtre d’affichage en sélectionnant l’icône d’engrenage dans le menu global de l’Explorateur de données en haut à droite, puis en sélectionnant Effacer l’historique.

Utilisation de l’historique des filtres

L’historique des filtres vous permet de revoir et d’appliquer rapidement des filtres précédents. Cela élimine la tâche répétitive de reconstruction manuelle des filtres pour les requêtes périodiques. Avec l’historique des filtres, vous pouvez accéder à un journal de vos filtres passés et les réappliquer en un simple clic.  Cette fonctionnalité sera précieuse aux utilisateurs qui effectuent des analyses régulières sur des jeux de données similaires.

1. Appliquer un filtre enregistré

2. Une fois dans l’Explorateur de données, ouvrez la collection à interroger et sélectionnez Éléments.

3. Cliquez sur Modifier le filtre.

4. Appliquez un filtre à vos données comme vous le feriez normalement.

Une fois appliqué, votre filtre est automatiquement enregistré et ajouté à la liste de filtres par défaut dans la liste déroulante de la fenêtre de filtres.

1. Pour réappliquer un filtre précédent, cliquez sur le bouton Modifier le filtre.

2. Effacez n’importe quel filtre de la fenêtre de filtres. Cette étape est nécessaire pour pouvoir afficher vos filtres enregistrés.

3. Cliquez sur la liste déroulante dans la fenêtre de filtres, puis sélectionnez le filtre souhaité dans la liste.

4. Sélectionnez Appliquer le filtre.

5. Effacer votre historique des filtres

6. Dans l’Explorateur de données, cliquez sur l’icône d’engrenage dans le coin supérieur droit pour accéder aux paramètres.

7. Sélectionnez le bouton Effacer l’historique.

8. Confirmez que vous souhaitez effacer votre historique.  Cela inclut les positions des séparateurs de colonnes de filtre, les colonnes personnalisées et la disposition de votre onglet.

Modifier l’affichage de la fenêtre de requête

Nous avons introduit une nouvelle fonctionnalité dans l’affichage de requête qui vous permet de basculer entre les vues horizontales et verticales pour le volet de requête et de résultats. Vous pouvez facilement basculer entre ces vues en sélectionnant l’option « Affichages » dans le menu de la barre de commandes.

1. Enregistrer les préférences d’affichage de la fenêtre de requête

2. Dans l’Explorateur de données, cliquez sur l’icône d’engrenage dans le coin supérieur droit pour accéder aux paramètres.

3. Sélectionnez « Affichage des résultats de requêtes par défaut » dans le menu déroulant.

4. Sélectionnez Horizontale ou Verticale comme vue par défaut.

5. Cliquez sur Enregistrer pour appliquer vos paramètres.

Configurer le seuil des unités de requête

Dans l’Explorateur de données, 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.

   

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.

   

   > [!TIP]
   

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

Utiliser l’Authentification avec Microsoft Entra

Vous pouvez utiliser l’authentification basée sur Microsoft Entra dans l’Explorateur en l’activant via la configuration. Pour plus d’informations sur le contrôle d’accès en fonction du rôle, consultez le guide de sécurité.

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

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

3. Dans la boîte de dialogue Paramètres, configurez si vous souhaitez Enable Entra ID (RBAC) à l’aide de l’une des trois valeurs possibles :

	Description
Automatique (par défaut)	Le contrôle d’accès en fonction du rôle (RBAC) est automatiquement utilisé si l’authentification basée sur des clés est désactivée pour votre compte. Sinon, l’Explorateur de données utilise l’authentification basée sur des clés pour les requêtes de données.
True	Le contrôle d’accès en fonction du rôle est toujours utilisé pour les requêtes de données. Si le contrôle d’accès en fonction du rôle n’est pas configuré correctement pour le compte ou l’identité, les requêtes échouent.
False	L’authentification basée sur des clés est toujours utilisée pour les requêtes de données. Si l’authentification basée sur des clés est désactivée, les requêtes échouent.

Remarque

La modification de ce paramètre en option qui utilise l’authentification basée sur des clés peut déclencher une requête de récupération de la clé primaire pour le compte de l’identité qui est connectée.

4. L’Explorateur de données se connecte automatiquement à l’aide de votre compte. Une brève fenêtre contextuelle peut s’afficher, sans vous inviter à entrer des informations d’identification. Si la connexion automatique échoue ou si les fenêtres contextuelles sont bloquées dans votre navigateur, vous devez utiliser le bouton Connexion pour RBAC Entra ID (situé dans la barre de commandes de l’Explorateur de données) et autoriser les fenêtres contextuelles pour l’Explorateur de données avant d’effectuer des requêtes de données.

   Conseil

   L’Explorateur de données Azure Cosmos DB prend également en charge l’option permettant de définir manuellement la valeur du Enable Entra ID (RBAC) sur True à l’aide de l’URL https://cosmos.azure.com?feature.enableAadDataPlane=true.

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 de données.

Étape suivante

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