Connexion Power BI vers Query Service

Ce document décrit les étapes de connexion. Power BI Bureau avec Adobe Experience Platform Query Service.

Prise en main

Ce guide nécessite que vous ayez déjà accès à la fonction Power BI de l’appli de bureau et connaissent comment naviguer dans son interface. Pour télécharger Power BI Bureau ou pour plus d’informations, voir officiel Power BI documentation.

IMPORTANT

Le Power BI L’appli de bureau est only disponible sur les périphériques Windows.

Pour acquérir les informations d’identification nécessaires à la connexion Power BI pour Experience Platform, vous devez avoir accès à l’espace de travail Requêtes dans l’interface utilisateur de Platform. Contactez votre administrateur de l’organisation IMS si vous n’avez pas actuellement accès à l’espace de travail Requêtes .

Après installation Power BI, vous devez installer . Npgsql, un package de pilote .NET pour PostgreSQL. Vous trouverez plus d’informations sur Npgsql dans la section Documentation Npgsql.

IMPORTANT

Vous devez télécharger la version v4.0.10 ou antérieure, car les versions plus récentes génèrent des erreurs.

Sous "Npgsql GAC Installation" sur l’écran de configuration personnalisé, sélectionnez Will be installed on local hard drive.

Pour vous assurer que Npgsql a été correctement installé, redémarrez votre ordinateur avant de passer aux étapes suivantes.

Connexion Power BI vers Query Service

Pour se connecter Power BI à Query Service, ouvrez Power BI et sélectionnez Get Data dans le ruban du menu supérieur.

Le Power BI onglet Accueil du tableau de bord avec l’option Obtenir les données mise en surbrillance.

Saisissez "PostgreSQL" dans la barre de recherche pour limiter la liste des sources de données. Sous les résultats qui s’affichent, sélectionnez PostgreSQL database, suivie de Connect.

Boîte de dialogue Obtenir des données avec PostgreSQL et Connecter en surbrillance.

Le PostgreSQL la boîte de dialogue de base de données s’affiche, vous demandant des valeurs pour votre serveur et votre base de données. Ces valeurs 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, suivi de Informations d’identification. Pour plus d’informations sur la recherche du nom de la base de données, de l’hôte, du port et des informations de connexion, consultez la section guide des informations d’identification.

L’espace de travail Requêtes Experience Platform avec l’onglet Informations d’identification et Informations d’identification arrivant à expiration est mis en surbrillance.

Pour le Server dans Power BI, saisissez la valeur de l’hôte figurant 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 Database peut être "all" ou un nom de table de jeu de données. Par exemple : prod:all.

IMPORTANT

Les structures de données imbriquées dans des outils de BI tiers peuvent être aplaties afin d’améliorer leur convivialité et de réduire la charge de travail requise pour récupérer, analyser, transformer et générer des rapports sur les données. Consultez la documentation relative à laFLATTEN fonctionnalité pour savoir comment activer ce paramètre lors de la connexion à une base de données.

Le Power BI tableau de bord avec les champs de saisie du serveur et de la base de données mis en surbrillance.

Mode Connectivité des données

Ensuite, vous pouvez sélectionner votre Data Connectivity mode. Sélectionner Import suivie de OK pour afficher la liste de tous les tableaux 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 Import , veuillez lire la section sur importation d'un tableau. Pour en savoir plus sur DirectQuery , veuillez lire la section sur interrogation d’un jeu de données sans importer de données.

Sélectionner OK après avoir confirmé les détails de votre base de données.

Le PostgreSQL Boîte de dialogue de base de données avec le mode Connectivité des données en surbrillance.

Authentification

Une invite vous demandant votre nom d’utilisateur, votre mot de passe et vos paramètres d’application s’affiche. Dans ce cas, le nom d’utilisateur est votre ID 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.

La boîte de dialogue de base de données avec le nom d’utilisateur, le mot de passe et les paramètres d’application est mise en surbrillance.

Importer un tableau

En sélectionnant la variable 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 la variable Power BI application de bureau en l’état.

IMPORTANT

Pour afficher les modifications de données qui se sont produites depuis l’importation initiale, vous devez actualiser les données dans Power BI en important à nouveau le jeu de données complet.

Pour importer un tableau, saisissez les détails du serveur et de la base de données. comme décrit ci-dessus et sélectionnez la variable Import Data Connectivity mode, suivie de OK. Une boîte de dialogue s’affiche, affichant la liste de tous les tableaux disponibles. Sélectionnez le tableau à prévisualiser, puis choisissez Load pour mettre en Power BI le jeu de données.

La boîte de dialogue Navigateur avec un tableau et l’option Chargement en surbrillance.

Le tableau est maintenant importé dans Power BI.

Le Power BI tableau de bord avec des instructions sur la création de visualisations personnalisées mises en surbrillance.

Importation de tableaux à l’aide de 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 PostgreSQL fenêtre contextuelle de base de données, sélectionnez Advanced options pour saisir une requête SQL personnalisée dans le SQL statement . Cette requête personnalisée doit être utilisée pour aplatir vos paires nom-valeur JSON dans un format de tableau.

Le PostgreSQL Boîte de dialogue de base de données avec les options avancées du mode de connectivité des données mises en surbrillance. Ils vous permettent de créer une instruction SQL personnalisée.

Après avoir saisi votre requête personnalisée, sélectionnez OK pour poursuivre la connexion à votre base de données. Voir authentication 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 la Power BI Tableau de bord du bureau sous la forme d’un tableau. Le nom du serveur et du nom de la base de données sont répertoriés en haut de la boîte de dialogue. Sélectionner Load pour terminer le processus d’importation.

Visualisation d’un tableau importé aplati dans la variable Power BI tableau de bord.

Les visualisations peuvent désormais être modifiées et exportées à partir du Power BI Application de bureau.

Interrogation du jeu de données sans importation de données

Le DirectQuery Data Connectivity mode interroge directement la source de données sans importer ou copier les données dans la variable Power BI Bureau. 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.

Pour utiliser Data Connectivity mode, sélectionnez la variable DirectQuery bascule puis Advanced options pour saisir une requête SQL personnalisée dans le SQL statement . Assurez-vous que Include relationship columns est sélectionnée. Une fois la requête terminée, sélectionnez OK pour continuer.

Le PostgreSQL Boîte de dialogue de base de données avec les paramètres requis pour utiliser le mode Connectivité des données mis en surbrillance.

Un aperçu de votre requête s’affiche. Sélectionner Load pour afficher les résultats de la requête.

Aperçu des résultats tabulés de l’exemple de requête.

Étapes suivantes

En lisant ce document, vous devez maintenant comprendre comment vous connecter à la Power BI Application de bureau 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 à la section conseils pour l’exécution des requêtes.

Sur cette page