Connecter aux données Analytics à l’aide du flux OData Power BI

Article
03/20/2024

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Vous pouvez accéder aux données Analytics via le flux OData Power BI Desktop.

Important

La méthode illustrée dans cet article fonctionne pour les petites organisations, car elle extrait toujours toutes les données dans Power BI. La plupart des filtrages spécifiés dans la Éditeur Power Query sont effectués côté client. Pour plus d’informations sur d’autres approches, consultez Vue d’ensemble de l’intégration de Power BI.

Prérequis

Pour afficher les données Analytics et interroger le service, vous devez être membre d’un projet avec un accès de base ou supérieur. Par défaut, tous les membres du projet sont autorisés à interroger Analytics et à définir des vues Analytics.
Pour en savoir plus sur les autres prérequis concernant l’activation des services et des fonctionnalités et les activités générales de suivi des données, consultez Autorisations et prérequis pour accéder à Analytics.

Accéder au flux OData Analytics

Important

Vérifiez que vous avez activé ou installé Analytics.

Vérifiez que vous avez configuré les autorisations requises pour accéder à Analytics.
Ouvrez Power BI Desktop. Si ce n’est déjà fait, installez Power BI Desktop maintenant.
Dans la page d’accueil ou le ruban d’accueil de Power BI Desktop, sélectionnez Obtenir des données.
Dans le volet gauche, sélectionnez Autre>flux OData, puis Connecter.
Dans un navigateur pris en charge, entrez l’URL au format https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/.

Par exemple, si {OrganizationName} est fabrikam et {version} est v1.0, l’URL est https://analytics.dev.azure.com/fabrikam/_odata/v1.0/.

Remarque

Vous pouvez également entrer l’URL avec projectName spécifié, comme illustré dans l’exemple suivant :
https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/ L’utilisation de ce format réduit les résultats par le projet spécifié sur toutes les entités associées à ce projet.
À l’invite, authentifiez-vous auprès du service. Si ce n’est déjà fait, consultez les options d’authentification du client.
Sélectionnez les zones case activée en regard des entités dont vous souhaitez récupérer les données.

Important

Ne sélectionnez pas d’entités dont le nom inclut l’instantané. Ces entités contiennent l’état de chaque élément de travail chaque jour depuis la création de l’élément de travail. Pour les dépôts de toute taille, la sélection de ces entités entraîne l’échec du chargement de dizaines à des centaines de millions d’éléments de travail. Les tables d’instantanés sont destinées uniquement aux requêtes d’agrégation.
Sélectionnez Transformer les données. Ne sélectionnez pas Charger.
Important

Pour chaque entité que vous avez sélectionnée, Power Query crée une requête. Chaque requête doit être mise à jour manuellement, car cela empêche les erreurs de limitation. Power Query tente de résoudre les valeurs Null en tant qu’erreurs en générant une requête supplémentaire pour chaque valeur null qu’elle rencontre. Cela peut entraîner des milliers de requêtes, qui dépassent rapidement votre seuil d’utilisation, au-delà duquel votre compte d’utilisateur sera limité.

Pour éviter ce problème :
- Demandez à Power BI de référencer OData v4.
- Demandez au service Analytics d’omettre toutes les valeurs null, ce qui améliore les performances des requêtes.
Pour chaque entité que vous avez sélectionnée dans les étapes précédentes, procédez comme suit :

a. Dans la liste Requêtes , sélectionnez une entité dont vous souhaitez effectuer la requête. Dans cet exemple, Zones est sélectionnée.

b. Dans le ruban, sélectionnez Éditeur avancé.

c. Dans le volet Requête , faites défiler horizontalement pour afficher le [Implementation="2.0"] paramètre.

d. Remplacez par [Implementation="2.0"] la chaîne suivante :
[Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]
Cliquez sur Fermer et appliquer.