Connecter Power BI à Query Service
Ce document décrit les étapes à suivre pour connecter Power BI Desktop à Adobe Experience Platform Query Service.
Prise en main
Ce guide nécessite que vous ayez déjà accès à l’application Power BI Desktop et que vous sachiez comment naviguer dans son interface. Pour télécharger Power BI Desktop ou pour plus d’informations, consultez la documentation officielle de Power BI.
Pour acquérir les informations d’identification nécessaires à la connexion de Power BI à Experience Platform, vous devez avoir accès à l’espace de travail Requêtes dans l’interface utilisateur de Platform. Contactez l’administrateur ou administratrice de votre organisation si vous n’avez pas actuellement accès à l’espace de travail des requêtes.
Connecter Power BI à Query Service connect-power-bi
Pour connecter Power BI à Query Service, ouvrez Power BI et sélectionnez Get Data dans le ruban du menu supérieur. Ensuite, saisissez « PostgreSQL » dans la barre de recherche pour affiner la liste des sources de données. Dans les résultats qui s’affichent, sélectionnez PostgreSQL database, puis Connect.
La boîte de dialogue de base de données PostgreSQL s’affiche, vous demandant des valeurs pour votre serveur et votre base de données. Vous pouvez consulter des instructions supplémentaires sur la manière de se connecter à la base de données PostgreSQL à partir de Power Query Desktop dans la documentation de PowerBI.
Ces valeurs requises proviennent de vos informations d’identification Adobe Experience Platform. Pour trouver vos informations d’identification, connectez-vous à l’interface utilisateur de Platform et sélectionnez Requêtes à partir du volet de navigation de gauche, puis Informations d’identification. Pour plus d’informations sur la manière dont trouver le nom, l’hôte et le port de votre base de données ainsi que vos informations d’identification de connexion, consultez le guide des informations d’identification.
Dans le champ Server de la boîte de dialogue PostgreSQL database, saisissez la valeur de l’hôte trouvé dans la section Informations d’identification de Query Service. Pour la production, ajoutez le port :80 à la fin de la chaîne hôte. Par exemple : made-up.platform-query.adobe.io:80.
Le champ Database peut être « all » ou un nom de table de jeu de données. Par exemple : prod:all.
FLATTEN fonctionnalité pour savoir comment activer ce paramètre lors de la connexion à une base de données.Mode Connectivité des données data-connectivity-mode
Ensuite, vous pouvez sélectionner votre Data Connectivity mode. Dans la boîte de dialogue PostgreSQL database, sélectionnez Import puis OK pour afficher la liste de toutes les tables disponibles, ou sélectionnez DirectQuery pour interroger directement la source de données sans importer ou copier directement des données dans Power BI.
Pour en savoir plus sur le mode Import, consultez la section sur l’importation d’un tableau. Pour en savoir plus sur DirectQuery, consultez la section sur l’interrogation d’un jeu de données sans importer de données.
Sélectionnez OK après avoir confirmé les détails de votre base de données.
Authentification authentication
Après avoir confirmé votre mode de connectivité des données, une invite vous demandant votre nom d’utilisateur, votre mot de passe et les paramètres de votre application s’affiche. Dans ce cas, le nom d’utilisateur est votre identifiant d’organisation et le mot de passe est votre jeton d’authentification. Les deux se trouvent sur la page des informations d’identification de Query Service.
Renseignez ces informations, puis sélectionnez Connect pour passer à l’étape suivante.
Importer un tableau import
En sélectionnant le Import Data Connectivity mode, le jeu de données complet est importé, ce qui permet d’utiliser les tableaux et colonnes sélectionnés dans l’application Power BI Desktop en l’état.
Pour importer une table, saisissez les détails du serveur et de la base de données comme décrit ci-dessus et sélectionnez le Import Data Connectivity mode, puis OK. La boîte de dialogue Navigator apparaît, affichant une liste de tous les tableaux disponibles. Sélectionnez le tableau à prévisualiser, puis choisissez Load pour mettre le jeu de données dans Power BI. Le tableau est maintenant importé dans Power BI.
L’application Informations générales sur la connexion aux données dans PowerBi Desktop est disponible dans la documentation officielle.
Importer des tableaux à l’aide du SQL personnalisé
Power BI et d’autres outils tiers tels que Tableau ne permettent pas actuellement aux utilisateurs d’importer des objets imbriqués, tels que des objets XDM dans Platform. Pour en tenir compte, Power BI vous permet d’utiliser du code SQL personnalisé pour accéder à ces champs imbriqués et créer une vue aplatie des données. Power BI charge ensuite cette vue aplatie des données précédemment imbriquées comme un tableau normal.
Dans la boîte de dialogue PostgreSQL database, sélectionnez Advanced options pour saisir une requête SQL personnalisée dans la section SQL statement. Cette requête personnalisée doit être utilisée pour aplatir vos paires nom-valeur JSON dans un format de tableau. La documentation officielle fournit également des informations sur la manière de connecter PowerBI à l’aide d’une instruction SQL dans les options avancées.
Après avoir saisi votre requête personnalisée, sélectionnez OK pour poursuivre la connexion à votre base de données. Consultez la section authentification ci-dessus pour plus d’informations sur la connexion d’une base de données à partir de cette partie du workflow.
Une fois l’authentification terminée, un aperçu des données aplaties s’affiche dans le tableau de bord Power BI Desktop sous la forme d’un tableau. Le nom du serveur et le nom de la base de données sont répertoriés en haut de la boîte de dialogue. Sélectionnez Load pour terminer le processus d’importation.
Les visualisations peuvent désormais être modifiées et exportées à partir de l’application Power BI Desktop.
Interroger le jeu de données sans importer les données direct-query
Les requêtes DirectQuery Data Connectivity mode interrogent directement la source de données sans importer ni copier les données sur Power BI Desktop. En utilisant ce mode de connexion, vous pouvez actualiser toutes les visualisations avec les données actives via l’interface utilisateur. Toutefois, le temps nécessaire à la création ou à l’actualisation de la visualisation varie en fonction des performances de la source de données sous-jacente.
Plus d’informations sur l’utilisation de DirectQuery ainsi qu’une discussion approfondie sur ses options de connectivité, cas d’utilisation et limites sont disponibles dans la documentation PowerBI.
Pour utiliser ce Data Connectivity mode, sélectionnez le bouton DirectQuery puis Advanced options pour saisir une requête SQL personnalisée dans la section SQL statement. Assurez-vous que Include relationship columns est sélectionné. Une fois la requête terminée, sélectionnez OK pour continuer.
Un aperçu de votre requête s’affiche. Sélectionnez Load pour afficher les résultats de la requête.
Étapes suivantes
En lisant ce document, vous devez maintenant comprendre comment vous connecter à l’application Power BI Desktop et les différents modes de connexion aux données disponibles. Pour plus d’informations sur l’écriture et l’exécution de requêtes, reportez-vous aux conseils pour l’exécution des requêtes.