Partager via

Se connecter avec des données à l’aide de requêtes Power BI et OData

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Pour extraire des données dans Power BI, nous vous recommandons d’utiliser des requêtes OData (Open Data Protocol). OData est une norme établie par l’Organisation pour l’avancement des normes d’information structurée (OASIS) et approuvée par l’Organisation internationale de normalisation et la Commission électrotechnique internationale (ISO/IEC). OData définit les meilleures pratiques pour créer et consommer des API REST. Pour plus d’informations, consultez la documentation OData.

Pour commencer rapidement, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData. Pour plus d’informations sur d’autres approches, consultez À propos de l’intégration de Power BI.

Power BI peut exécuter des requêtes OData, qui peuvent retourner un jeu de données filtré ou agrégé à Power BI. Les requêtes OData présentent deux avantages :

  • Tout le filtrage est effectué côté serveur. Seules les données dont vous avez besoin sont retournées, ce qui entraîne des temps d’actualisation plus courts.
  • Vous pouvez préagréger les données côté serveur. Une requête OData peut effectuer des agrégations telles que le cumul d'éléments de travail et les taux d'échec de compilation. Les agrégations sont effectuées côté serveur, et seules les valeurs d’agrégation sont retournées à Power BI. En utilisant la préagrégation, vous pouvez effectuer des agrégations sur des jeux de données volumineux sans avoir à extraire toutes les données détaillées dans Power BI.

Dans ce tutoriel, vous allez :

  • Écrire et tester des requêtes OData.
  • Exécutez une requête OData à partir de Power BI.

Prérequis

Catégorie Spécifications
Niveaux d’accès - Membre du projet.
- 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.

Utiliser Visual Studio Code pour écrire et tester des requêtes OData

Le moyen le plus simple d’écrire et de tester OData consiste à utiliser Visual Studio Code avec l’extension OData. Visual Studio Code est un éditeur de code gratuit disponible sur Windows, Mac et Linux. L’extension OData fournit une mise en surbrillance de syntaxe et d’autres fonctions utiles pour l’écriture et le test de requêtes.

Installer Visual Studio Code et l’extension OData

  1. Installez Visual Studio Code.

  2. Ouvrez Visual Studio Code, sélectionnez Extensions, puis recherchez odata. Dans la liste des résultats, sélectionnez vscode-odata, puis installez cette extension.

  3. Dans Visual Studio Code, créez un fichier OData en créant un fichier vide qui a l’extension .odata. Vous pouvez le nommer comme vous le souhaitez, par exemple, filename.odata. Mais elle doit avoir une extension .odata pour activer la fonctionnalité d’extension OData.

Écrire la requête OData

Écrivez la requête OData. Pour obtenir des exemples de requêtes, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

La requête suivante renvoie les 10 premiers éléments de travail sous un chemin d'accès spécifique. Pour utiliser cette requête, remplacez {organization}, {project}et {area path} par vos valeurs.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
      $select=WorkItemId,Title,WorkItemType,State,CreatedDate
      &$filter=startswith(Area/AreaPath,'{area path}')
      &$orderby=CreatedDate desc
      &$top=10

Pour interroger des projets, omettez /{project} entièrement.

Pour plus d’informations, consultez Exemples de rapports et index de référence rapide.

Après avoir écrit la requête dans Visual Studio Code, vous devriez voir la mise en surbrillance de la syntaxe.

Capture d’écran montrant un fichier OData dans Visual Studio Code. Chaque type d’élément de code a sa propre couleur.

Tester la requête OData

  1. Pour tester la requête OData, placez votre curseur n’importe où dans le texte de la requête, puis sélectionnez Afficher> lapalette de commandes.

  2. Dans la zone de recherche, entrez odata pour afficher les commandes OData.

    Capture d’écran montrant la palette de commandes de l’extension OData Visual Studio Code.

  3. Sélectionnez OData : Ouvrir. Cette action combine la requête multiligne dans une URL à une seule ligne, exécute la requête et ouvre les résultats dans votre navigateur par défaut.

    • Le jeu de résultats de requête OData est au format JSON. Pour afficher les résultats, installez une extension de formateur JSON pour votre navigateur. Plusieurs options sont disponibles pour Chrome et Microsoft Edge.

      Capture d’écran d’un navigateur montrant la sortie JSON de la requête OData affichée dans un format lisible.

    • Si la requête a une erreur, le service Analytics retourne une erreur au format JSON. Par exemple, l’erreur suivante indique que la requête sélectionne un champ qui n’existe pas.

      Capture d’écran d’un navigateur montrant la sortie JSON dans un format lisible. Un message dans la sortie indique une erreur dans une requête OData.

Après avoir vérifié que la requête fonctionne correctement, vous pouvez l’exécuter à partir de Power BI.

Exécuter la requête OData à partir de Power BI

Pour exécuter la requête OData à partir de Power BI, procédez comme suit.

Combiner la requête OData multiligne en une seule ligne

Avant d’utiliser la requête dans Power BI, vous devez convertir la requête OData multiligne en une seule ligne. Pour utiliser la commande OData : Combiner à cet effet, procédez comme suit :

  1. Effectuez une copie du fichier OData qui contient votre texte de requête multiligne. Cette étape est recommandée, car il n’existe aucun moyen de convertir la requête en ligne unique en requête multiligne lisible.

  2. Dans Visual Studio Code, ouvrez la copie de votre fichier OData et placez votre curseur n’importe où dans le texte de la requête.

  3. Sélectionnez Afficher>Palette de commandes. Dans la zone de recherche, entrez odata. Ensuite, dans la liste des résultats, sélectionnez OData : Combiner.

    La requête multiligne est convertie en une seule ligne.

    Capture d’écran d’un fichier OData dans Visual Studio Code. Le fichier contient une requête multiligne suivie de la version monoligne de la requête.

  4. Copiez la ligne entière à utiliser dans la section suivante.

Exécuter la requête à partir de Power BI

  1. Dans Power BI, sélectionnez Obtenir les données>flux OData. Pour plus d’informations, consultez Créer un rapport Power BI avec une requête OData.

    Capture d’écran de Power BI avec Obtenir des données et Flux OData mis en surbrillance.

  2. Dans la fenêtre de flux OData , dans la zone URL , collez la requête OData que vous avez copiée dans la section précédente, puis sélectionnez OK.

    Capture d’écran de la boîte de dialogue flux OData. La zone URL contient la requête OData à ligne unique.

    Power BI affiche une page d’aperçu.

    Capture d’écran d’une page d’aperçu dans Power BI avec des boutons permettant de charger et de transformer des données. Un tableau répertorie des informations sur plusieurs éléments de travail.

Spécifier les options de requête

  1. Dans la page d’aperçu, sélectionnez Transformer des données pour ouvrir l’Éditeur Power Query.

    Capture d’écran de l’éditeur Power Query. Une table répertorie les données de flux OData pour plusieurs éléments de travail.

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

    Capture d’écran du ruban Power BI. L’éditeur avancé est mis en surbrillance.

  3. Dans la fenêtre Éditeur avancé, faites défiler horizontalement pour afficher le [Implementation="2.0"] paramètre dans la requête.

    Capture d’écran de la fenêtre Éditeur avancé. La fin de la requête est visible et le paramètre d’implémentation est mis en surbrillance.

  4. Remplacez [Implementation="2.0"] par la chaîne suivante :

    [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

    Capture d’écran de la fenêtre Éditeur avancé. La fin de la requête est visible. Elle contient la chaîne de remplacement et est mise en surbrillance.

    Cette modification permet d'éviter les erreurs de limitation. Les nouvelles valeurs ont l’effet suivant :

    • Ils demandent à Power BI de référencer OData version 4.
    • Ils demandent au service Analytics d’omettre toutes les valeurs null, ce qui améliore les performances des requêtes.

    Power Query tente de résoudre les valeurs Null en tant qu’erreurs en générant une autre requête pour chaque valeur Null qu’elle rencontre. Cette action peut entraîner des milliers de requêtes. Ces requêtes peuvent rapidement dépasser votre seuil d’utilisation, au-delà duquel votre compte d’utilisateur est limité.

  5. Sélectionnez Terminé pour fermer l’éditeur avancé et revenir à l’éditeur Power Query Power BI. Vous pouvez utiliser Éditeur Power Query pour effectuer les actions facultatives suivantes :

    • Renommez la Query1 requête comme quelque chose de plus spécifique.
    • Transformez des colonnes en un type spécifique. Power BI détecte automatiquement le type, mais vous pouvez convertir des colonnes en un type de données spécifique.
    • Ajoutez des colonnes calculées.
    • Supprimer des colonnes.
    • Étendre les colonnes en champs spécifiques.

Créer un rapport à l’aide des données

Sélectionnez Fermer & Appliquer pour enregistrer vos paramètres et extraire les données dans Power BI. Une fois les données actualisées, vous pouvez créer un rapport comme vous le faites normalement dans Power BI.

Capture d’écran du ruban Power BI. Le bouton Fermer &Appliquer est mis en surbrillance.

Contenu connexe

  • Last updated on