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

  • Article

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

Découvrez comment 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

  • Accès : être membre d’un projet avec au moins un accès de base .
  • Autorisations : par défaut, les membres du projet ont l’autorisation d’interroger Analytics et de créer des vues.
  • Pour plus d’informations sur les autres prérequis concernant l’activation du service et des fonctionnalités et les activités de suivi des données générales, consultez Autorisations et conditions préalables pour accéder à Analytics.

Accéder au flux OData Analytics

Important

Vérifiez que vous avez activé ou installé l’extension Analytics.

  1. Configurez les autorisations requises pour accéder à Analytics.

  2. Ouvrez Power BI Desktop.

  3. Dans la page d’accueil ou le ruban d’accueil de Power BI Desktop, sélectionnez Obtenir des données.

    Capture d’écran de démarrage de Power BI Desktop, bouton Obtenir des données.

  4. Sélectionnez Autre>connexion de flux>OData.

    Capture d’écran montrant le bouton Flux OData.

  5. Dans un navigateur pris en charge, entrez l’URL au format https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/suivant.

    Par exemple, si {OrganizationName} est fabrikam et {version} est v1.0, l’URL est https://analytics.dev.azure.com/fabrikam/_odata/v1.0/. La version que vous devez utiliser dépend de la dernière version prise en charge pour Analytics OData.

    Capture d’écran de l’URL de flux OData.

    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’étendue des données est toujours au niveau du projet par conception. Vous ne pouvez donc pas vous connecter au niveau de l’organisation. Si vous souhaitez obtenir toutes les données de tous vos projets, vous devez vous connecter à une à la fois.

  6. À l’invite, authentifiez-vous auprès du service.

  7. Cochez les cases 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 référentiels 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.

    Capture d’écran de la liste Entités sur la page Navigateur.

  8. 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. Vous devez mettre à jour manuellement chaque requête pour éviter 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. Cette action peut entraîner des milliers de requêtes, qui peuvent rapidement dépasser votre seuil d’utilisation, au-delà duquel votre compte d’utilisateur est 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.

  9. 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.

    Capture d’écran de la liste requêtes de flux OData Power BI.

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

    Capture d’écran du bouton Flux OData Power BI Éditeur avancé.

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

    Capture d’écran du volet Éditeur avancé Requête.

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

    Capture d’écran montrant la chaîne remplacée.

  10. Cliquez sur Fermer et appliquer.

Contenu connexe