Visualiser des données Azure Cosmos DB à l’aide de Power BI

S’APPLIQUE À : NoSQL

Cet article décrit les étapes requises pour connecter des données Azure Cosmos DB à Power BI Desktop.

Vous pouvez vous connecter à Azure Cosmos DB à partir de Power BI Desktop à l’aide de l’une des options suivantes :

• Azure Synapse Link vous permet de générer des rapports Power BI sans que cela ait la moindre incidence sur les performances ou les coûts de vos charges de travail transactionnelles, et sans pipeline ETL.

  Vous pouvez utiliser les modes DirectQuery ou importation. Le mode DirectQuery vous permet de créer des tableaux de bord/rapports à l’aide de données en direct provenant de vos comptes Azure Cosmos DB, sans importer ou copier les données dans Power BI.

• Connectez Power BI Desktop à un compte Azure Cosmos DB via le connecteur Azure Cosmos DB pour Power BI. Cette option est disponible uniquement en mode Importation et consomme des unités de travail allouées pour vos charges de travail transactionnelles.

Notes

Les rapports créés dans Power BI Desktop peuvent ensuite être publiés sur PowerBI.com. L’extraction directe des données Azure Cosmos DB ne peut pas être effectuée sur PowerBI.com.

Prérequis

Avant de suivre les instructions de ce didacticiel Power BI, assurez-vous de disposer des ressources suivantes :

• Télécharger la dernière version de Power BI Desktop.

• Créez un compte de base de données Azure Cosmos DB et ajoutez des données à vos conteneurs Azure Cosmos DB.

Pour partager vos rapports dans PowerBI.com, vous devez disposer d’un compte sous PowerBI.com. Pour en savoir plus Power BI et Power BI Pro, visitez https://powerbi.microsoft.com/pricing.

Prise en main

Génération de rapports BI à l’aide d’Azure Synapse Link

Vous pouvez activer Azure Synapse Link sur vos conteneurs Azure Cosmos DB existants et générer des rapports BI sur ces données en quelques clics à l’aide du portail Azure Cosmos DB. Power BI se connectera à Azure Cosmos DB en utilisant le mode DirectQuery qui vous permet d’interroger vos données Azure Cosmos DB en direct, sans affecter vos charges de travail transactionnelles.

Pour générer un rapport ou un tableau de bord Power BI :

1. Connectez-vous au portail Azure et accédez à votre compte Azure Cosmos DB.

2. Dans la section Intégrations, ouvrez le panneau Power BI et sélectionnez Commencer.

   Notes

   Actuellement, cette option n’est disponible que pour les comptes API pour NoSQL. Vous pouvez créer des affichages T-SQL directement dans des pools SQL serverless Synapse et générer des tableaux de bord BI pour Azure Cosmos DB for MongoDB. Pour plus d’informations, consultez Utiliser Power BI et un pool Synapse SQL serverless pour analyser des données Azure Cosmos DB avec Synapse Link.

3. À partir de l’onglet Activer Azure Synapse Link, vous pouvez activer Synapse Link sur votre compte à partir de la section Activer Azure Synapse Link pour ce compte. Si Synapse Link est déjà activé pour votre compte, vous ne verrez pas cet onglet. Cette étape est une condition préalable à l’activation de Synapse Link sur vos conteneurs.

   Notes

   L’activation d’Azure Synapse Link a des conséquences sur la tarification. Pour plus d’informations, consultez la section Tarification Azure Synapse Link.

4. Ensuite, dans la section Activer Azure Synapse Link pour vos conteneurs, choisissez les conteneurs requis pour activer Synapse Link.

   • Si vous avez déjà activé Synapse Link sur certains conteneurs, la case à cocher en regard du nom du conteneur est sélectionnée. Le cas échéant, vous pouvez les désélectionner en fonction des données que vous souhaitez visualiser dans Power BI.

   • Si Synapse Link n’est pas activé, vous pouvez l’activer sur vos conteneurs existants.

     Si l’activation de Synapse Link est en cours sur des conteneurs, les données de ces conteneurs ne seront pas incluses. Vous devrez revenir plus tard dans cet onglet et importer les données lorsque les conteneurs sont activés.

   

5. Selon la quantité de données dans vos conteneurs, l’utilisation de Synapse Link peut prendre un certain temps. Pour en savoir plus, consultez l’article Activer Synapse Link sur des conteneurs existants.

   Vous pouvez vérifier la progression dans le portail, comme montré dans l’écran suivant. Les conteneurs sont activés avec Synapse Link lorsque l’avancement atteint 100 %.

   

6. Dans l’onglet Sélectionner un espace de travail, sélectionnez l’espace de travail Azure Synapse Analytics, puis cliquez sur Suivant. Cette étape crée automatiquement des vues T-SQL dans Synapse Analytics pour les conteneurs sélectionnés précédemment. Pour plus d’informations sur les vues T-SQL nécessaires pour connecter votre Azure Cosmos DB à Power BI, consultez l’article Préparer les vues.

   Notes

   Vos propriétés de conteneur Azure Cosmos DB sont représentées sous forme de colonnes dans les vues T-SQL, y compris les données JSON imbriquées en profondeur. Il s’agit d’un démarrage rapide pour vos tableaux de bord BI. Ces vues seront disponibles dans votre espace de travail/base de données Synapse. Vous pouvez également utiliser ces mêmes vues dans l’espace de travail Synapse pour l’exploration des données, la science des données, l’ingénierie données, etc. Notez que les scénarios avancés peuvent exiger des vues plus complexes ou un ajustement de ces vues, pour de meilleures performances. Pour plus d’informations, consultez Bonnes pratiques pour Synapse Link lors de l’utilisation de pools SQL serverless Synapse.

7. Vous pouvez choisir un espace de travail existant ou en créer un. Pour sélectionner un espace de travail existant, fournissez l’abonnement, l’espace de travail et les détails de la base de données. Le portail Azure utilisera vos informations d’identification Microsoft Entra pour se connecter automatiquement à votre espace de travail Synapse et créer des affichages T-SQL. Assurez-vous que vous disposez des autorisations « Administrateur Synapse » sur cet espace de travail.

   

8. Sélectionnez ensuite Télécharger .pbids pour télécharger le fichier source de données Power BI. Ouvrez le fichier téléchargé. Il contient les informations de connexion requises et ouvre Power BI Desktop.

   

9. Vous pouvez désormais vous connecter aux données Azure Cosmos DB à partir de Power BI Desktop. Une liste des vues T-SQL correspondant aux données de chaque conteneur s’affiche.

   Par exemple, l’écran suivant présente les données relatives à la flotte de véhicules. Vous pouvez charger ces données pour les analyser ou les transformer avant de les charger.

   

10. Vous pouvez désormais commencer à créer le rapport à l’aide des données analytiques d’Azure Cosmos DB. Toutes les modifications apportées à vos données sont reflétées dans le rapport une fois les données répliquées dans le magasin analytique, ce qui se produit généralement en quelques minutes.

Génération de rapports BI à l’aide d’un connecteur Power BI

Notes

La connexion à Azure Cosmos DB avec le connecteur Power BI est actuellement prise en charge uniquement pour les comptes Azure Cosmos DB for NoSQL et API pour Gremlin.

1. Démarrez Power BI Desktop.

2. Vous pouvez obtenir des données, consulter les Sources récentes ou Ouvrir d’autres rapports directement à partir de cet écran d’accueil. Cliquez sur le symbole X en haut à droite pour fermer l’écran. La vue Rapport de Power BI Desktop s’affiche.

   

3. Sélectionnez le ruban Accueil, puis cliquez sur Obtenir des données. La fenêtre Obtenir des données doit alors s’afficher.

4. Cliquez sur Azure, sélectionnez Azure Cosmos DB (bêta) puis cliquez sur Se connecter.

   

5. Sur la page Aperçu connecteur, cliquez sur Continuer. La fenêtre Azure Cosmos DB s’affiche.

6. Spécifiez l’URL du point de terminaison du compte Azure Cosmos DB dont vous souhaitez récupérer les données, comme indiqué ci-dessous, puis cliquez sur OK. Vous pouvez récupérer l’URL dans la zone URI du panneau Clés du portail Azure pour utiliser votre propre compte. Vous pouvez, de manière facultative, fournir un nom de base données, un nom de collection ou utiliser le Navigateur pour sélectionner la base de données et la collection afin d’identifier la provenance des données.

7. Si vous vous connectez pour la première fois à ce point de terminaison, le système vous demandera la clé du compte. Vous pouvez récupérer la clé dans la zone Clé primaire du panneau Clés en lecture seule du portail Azure pour votre propre compte. Entrez la clé appropriée, puis cliquez sur Connecter.

   nous vous recommandons d’utiliser la clé en lecture seule lorsque vous créez des rapports, ce afin de ne pas exposer inutilement la clé principale à des risques de sécurité potentiels. De cette façon, vous n’exposez pas inutilement la clé primaire à des risques de sécurité potentiels. La clé en lecture seule est disponible à partir du panneau Clés du portail Azure.

8. Une fois le compte connecté, le volet Navigateur s’affiche. Le Navigateur affiche une liste des bases de données attachées au compte.

9. Cliquez sur la base de données d’où proviennent les données du rapport, puis développez-la. Ensuite, sélectionnez une collection contenant les données à récupérer.

   le volet d’aperçu affiche une liste des éléments d’ enregistrement . Dans Power BI, un Document est représenté sous la forme d’un type d’ enregistrement . De même, un bloc JSON imbriqué à l’intérieur d’un document est également considéré comme un enregistrement. Pour afficher les documents des propriétés sous forme de colonnes, cliquez sur le bouton gris comportant 2 flèches dans les sens opposés qui symbolisent l’extension de l’enregistrement. Il se trouve à droite du nom du conteneur, dans le même volet de visualisation.

10. La vue Rapport de Power BI Desktop vous permet de créer des rapports pour visualiser des données. Pour créer des rapports, vous pouvez simplement faire glisser des champs et les déposer dans la zone de dessin Rapport .

11. Il existe deux manières d’actualiser les données, le modèle ad hoc et la planification. Cliquez simplement sur Actualiser maintenant pour actualiser les données. Consultez la documentation Power BI pour plus d’informations sur l’option d’actualisation planifiée.

Étapes suivantes

• Pour plus d’informations sur Power BI, consultez la section Get started with Power BI (Prise en main de Power BI).
• Pour en savoir plus sur Azure Cosmos DB, consultez la page d’accueil de la documentation relative à Azure Cosmos DB.