Passer au contenu principal

Power BI connector (REST API)

Utilisez le connecteur Power BI REST API pour récupérer des données grâce aux services OData de Cognite ou d’autres API Cognite à l’aide de requêtes GET, POST et GraphQL pour les modèles de données Cognite.

Bêta

Les fonctionnalités décrites dans cette section font actuellement l’objet de tests bêta avec certains clients, et sont susceptibles d’être modifiées.

Configuration d’une connexion avec Cognite Data Fusion (CDF)​

Procédez comme suit pour connecter un projet Cognite Data Fusion (CDF) en tant que source de données dans Power BI :

  1. Dans Power BI Desktop, inscrivez-vous avec le compte de votre organisation.

  2. Sous l’onglet Accueil, sélectionnez Obtenir des données, puis Plus. Dans la boîte de dialogue Obtenir des données, choisissez Cognite, puis sélectionnez le connecteur Cognite Data Fusion (REST API).

    Localiser le connecteur CDF REST API dans Power BI

  3. Dans la boîte de dialogue, entrez les détails requis pour configurer la connexion à CDF :

    • CDF project : Entrez le nom du projet CDF auquel vous souhaitez vous connecter.

    • CDF organization : Saisissez le nom de l’organisation à utiliser pour vous connecter à CDF.

    Configurer le connecteur CDF REST API dans Power BI

  4. Lorsque vous y êtes invité, entrez les identifiants de votre compte.

  5. Choisissez Connect pour ouvrir la fenêtre Navigator.

  6. Sélectionnez la ou les fonction(s) à utiliser, puis choisissez Transform Data pour ouvrir l’Power Query Editor et récupérer des données depuis CDF.

    Sélection de fonctions à l’aide du connecteur REST API dans Power BI

Utilisez la taille de page maximum autorisée si vous exécutez des requêtes qui prennent en charge la pagination (à l’aide des paramètres limit dans les requêtes GET/POST, ou à l’aide du paramètre first dans les requête GraphQL). Les tailles de page plus petites augmentent le nombre d’appels d’API, ce qui peut avoir un impact important sur le temps de chargement. Pour connaître la taille de page maximum prise en charge pour chaque point de terminaison, reportez-vous à la documentation de l’API Cognite. Dans le cas des requêtes GraphQL, la limite maximale équivaut à 1 000 instances par page.

Filtrage des données​

Lorsque vous utilisez les fonctions REST API, vous pouvez appliquer des filtres côté serveur pour limiter le volume de données initiales chargées dans Power BI.

Si vous faites appel à OData, Power BI peut envoyer certains filtres au service OData lorsque vous utilisez l’éditeur Power Query.

Dans le cas des requêtes GraphQL, vous pouvez appliquer directement des filtres dans la requête pour limiter la quantité de données chargées dans Power BI. Vous pouvez aussi utiliser des variables de requête GraphQL pour créer des requêtes paramétrables et les rendre plus faciles à réutiliser.

Actualisation planifiée​

Après avoir publié votre rapport auprès du service Power BI, vous pouvez planifier des opérations d’actualisation pour maintenir vos données à jour.

Traitement des erreurs​

Lorsque vous composez des requêtes GET et POST personnalisées, vous risquez d’obtenir des erreurs si l’URL fournie ou le corps de la requête ne sont pas valides. Si vous recevez un message d’erreur CogniteAPIError, reportez-vous à la documentation de référence de l’API Cognite et corrigez votre requête.

Dernière mise à jour