Connetti Power BI a Query Service

Questo documento descrive i passaggi per la connessione di Power BI Desktop a Adobe Experience Platform Query Service.

Introduzione

Questa guida richiede che tu abbia già accesso all'app desktop Power BI e che tu abbia familiarità con le modalità di navigazione nella relativa interfaccia. Per scaricare il desktop Power BI o per ulteriori informazioni, consulta la documentazione Power BI ufficiale.

Per acquisire le credenziali necessarie per la connessione di Power BI a Experience Platform, è necessario avere accesso all'area di lavoro Query nell'interfaccia utente di Platform. Se al momento non disponi dell’accesso all’area di lavoro query, contatta l’amministratore dell’organizzazione.

Dopo aver installato Power BI, sarà necessario installare Npgsql, un pacchetto driver .NET per PostgreSQL. Ulteriori informazioni su Npgsql sono disponibili nella documentazione di Npgsql.

In "Npgsql GAC Installation" nella schermata di installazione personalizzata, selezionare Will be installed on local hard drive.

Per verificare che Npgsql sia stato installato correttamente, riavviare il computer prima di procedere con i passaggi successivi.

Connetti Power BI a Query Service connect-power-bi

Per connettere Power BI a Query Service, apri Power BI e seleziona Get Data nella barra multifunzione del menu superiore. Quindi, immettere "PostgreSQL" nella barra di ricerca per limitare l'elenco delle origini dati. Dai risultati visualizzati, selezionare PostgreSQL database, seguito da Connect.

Viene visualizzata la finestra di dialogo del database PostgreSQL in cui vengono richiesti i valori per il server e il database. Ulteriori istruzioni su come connettersi a un database PostgreSQL da Power Query Desktop sono disponibili nella documentazione ufficiale di PowerBI.

Questi valori richiesti vengono ricavati dalle credenziali Adobe Experience Platform. Per trovare le credenziali, accedi all'interfaccia utente di Platform e seleziona Query dal menu di navigazione a sinistra, seguito da Credenziali. Per ulteriori informazioni su come trovare il nome del database, l'host, la porta e le credenziali di accesso, leggere la guida delle credenziali.

Nel campo Server della finestra di dialogo PostgreSQL database, immettere il valore per l'host trovato nella sezione Credenziali del servizio query. Per la produzione, aggiungere la porta :80 alla fine della stringa host. Ad esempio, made-up.platform-query.adobe.io:80.

Il campo Database può essere "all" o un nome di tabella di set di dati. Ad esempio, prod:all.

Modalità di connettività dati data-connectivity-mode

Quindi, puoi selezionare Data Connectivity mode. Nella finestra di dialogo PostgreSQL database, selezionare Import seguito da OK per visualizzare un elenco di tutte le tabelle disponibili oppure selezionare DirectQuery per eseguire direttamente query sull'origine dati senza importare o copiare dati direttamente in Power BI.

Per ulteriori informazioni sulla modalità Import, leggere la sezione su importazione di una tabella. Per ulteriori informazioni sulla modalità DirectQuery, leggere la sezione relativa a query su un set di dati senza importazione di dati.

Seleziona OK dopo aver confermato i dettagli del database.

Autenticazione authentication

Dopo aver confermato la modalità di connettività dati, viene visualizzato un messaggio in cui viene richiesto di specificare il nome utente, la password e le impostazioni dell’applicazione. Il nome utente in questo caso è l'ID organizzazione e la password è il token di autenticazione. Entrambi sono disponibili nella pagina Credenziali di Query Service.

Compila questi dettagli, quindi seleziona Connect per continuare con il passaggio successivo.

Importare una tabella import

Selezionando Import Data Connectivity mode, viene importato l'intero set di dati che consente di utilizzare le tabelle e le colonne selezionate nell'applicazione desktop Power BI così come sono.

Per importare una tabella, immettere i dettagli del server e del database come descritto in precedenza e selezionare Import Data Connectivity mode, seguito da OK. Viene visualizzata la finestra di dialogo Navigator in cui viene visualizzato un elenco di tutte le tabelle disponibili. Selezionare la tabella da visualizzare in anteprima, seguita da Load per portare il set di dati in Power BI. La tabella è ora importata in Power BI.

Informazioni generali sulla connessione ai dati nell'app PowerBi desktop sono disponibili nella documentazione ufficiale.

Importare tabelle utilizzando SQL personalizzato

Power BI e altri strumenti di terze parti come Tableau non consentono attualmente agli utenti di importare oggetti nidificati, ad esempio oggetti XDM in Platform. Per tenere conto di ciò, Power BI consente di utilizzare SQL personalizzato per accedere a questi campi nidificati e creare una visualizzazione semplificata dei dati. Power BI carica quindi questa vista appiattita dei dati precedentemente nidificati come una normale tabella.

Dalla finestra di dialogo PostgreSQL database, selezionare Advanced options per immettere una query SQL personalizzata nella sezione SQL statement. Questa query personalizzata deve essere utilizzata per "appiattire" le coppie nome-valore JSON in un formato di tabella. La documentazione ufficiale fornisce inoltre informazioni su come connettere PowerBI utilizzando un'istruzione SQL nelle opzioni avanzate.

Dopo aver immesso la query personalizzata, selezionare OK per continuare con la connessione al database. Consulta la sezione authentication qui sopra per istruzioni sulla connessione di un database da questa parte del flusso di lavoro.

Al termine dell'autenticazione, nel dashboard desktop Power BI verrà visualizzata un'anteprima dei dati appiattiti sotto forma di tabella. Il nome del server e del database sono elencati nella parte superiore della finestra di dialogo. Selezionare Load per completare il processo di importazione.

Le visualizzazioni sono ora disponibili per la modifica e l'esportazione dall'app desktop Power BI.

Eseguire una query sul set di dati senza importare dati direct-query

DirectQuery Data Connectivity mode esegue query direttamente sull'origine dati senza importare o copiare dati nel desktop Power BI. Utilizzando questa modalità di connessione, puoi aggiornare tutte le visualizzazioni con i dati correnti tramite l’interfaccia utente. Tuttavia, il tempo necessario per produrre o aggiornare la visualizzazione varia a seconda delle prestazioni dell’origine dati sottostante.

Ulteriori informazioni sull'utilizzo di DirectQuery e una discussione completa sulle opzioni di connettività, sui casi d'uso e sulle limitazioni sono disponibili nella documentazione ufficiale di PowerBI.

Per utilizzare Data Connectivity mode, selezionare l'interruttore DirectQuery e quindi Advanced options per immettere una query SQL personalizzata nella sezione SQL statement. Assicurarsi che Include relationship columns sia selezionato. Dopo aver completato la query, selezionare OK per continuare.

Viene visualizzata un’anteprima della query. Selezionare Load per visualizzare i risultati della query.

Passaggi successivi

Dopo aver letto questo documento, sarai in grado di capire come connettersi all'app desktop Power BI e alle diverse modalità di connessione dati disponibili. Per ulteriori informazioni su come scrivere ed eseguire query, consultare la guida per l'esecuzione delle query.