Denodo

Riassunto

Prerequisiti

Per usare questo connettore, installare e configurare la piattaforma Denodo e avviarne il servizio. Se si dispone di una connessione che usa un nome di origine dati ODBC , è necessario configurare correttamente la connessione nell'amministratore dell'origine dati ODBC.

Capacità supportate

• Importazione
• DirectQuery (modelli semantici di Power BI)

Connettersi a un'origine dati ODBC da Power Query Desktop

Per stabilire la connessione, seguire questa procedura:

1. Per connettersi ai dati, nella barra multifunzione Home selezionare Recupera dati. Nella sezione Database selezionare Denodo.

   

2. Esistono due modi per connettersi all'origine dati preferita:

   • DSN (nome origini dati ODBC)
   • stringa di connessione

   Nella finestra di dialogo Connettore Denodo , nella sezione DSN o Stringa di connessione specificare il nome dell'origine dati o la stringa di connessione, a seconda del tipo di connessione preferito.

   

   Quando si crea una stringa di connessione compatibile con Denodo, è necessario omettere il campo Driver , perché questo campo viene impostato in modo trasparente in fase di connessione dal connettore stesso.

   La stringa di connessione deve contenere tre parametri obbligatori: SERVER, PORTe DATABASE.

   SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>
   

   Inoltre, può contenere un parametro facoltativo: SSLmode.

   SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>;SSLmode=<SSL mode>
   

   Omettere i parametri di autenticazione. L'autenticazione viene configurata nei passaggi successivi.

   Annotazioni

   Quando si scrive la stringa di connessione, tenere presente i requisiti seguenti:

   • La stringa di connessione deve mantenere l'ordine corretto dei relativi parametri: SERVER, PORT, DATABASEe SSLMode.
   • Il nome di questi parametri deve essere sempre scritto nello stesso modo. Ad esempio, se si sceglie di scriverli in lettere maiuscole, devono essere sempre scritti in lettere maiuscole. Se si decide di scriverli con la prima lettera di una parola in maiuscolo e il resto delle lettere in minuscolo, devono sempre essere scritti in questo modo.

   Altrimenti, Power BI potrebbe non riconoscere i diversi set di dati Denodo in un report come appartenenti alla stessa origine dati Denodo. Di conseguenza, Power BI potrebbe richiedere credenziali di autenticazione separate per ognuna di esse.

3. La seconda sezione , Abilita la modalità di debug, è un campo facoltativo che consente di aggiungere informazioni di traccia ai file di log. Power BI Desktop crea questi file quando si abilita la traccia nell'applicazione usando la scheda Diagnostica del menu Opzioni . Il valore predefinito per Abilita la modalità di debug è false e in questo scenario non sono presenti dati di traccia nei file di log dal connettore personalizzato Denodo Power BI.

4. La terza sezione , Native Query, è un campo facoltativo in cui è possibile immettere una query. Se si usa questo campo di query, il set di dati è il risultato della query anziché una tabella o un set di tabelle.

   È possibile scrivere una query che interroga solo uno dei database a cui è associata l'origine dati.

   SELECT title, name FROM film JOIN language ON film.language_id = language.language_id WHERE film.language_id = 1
   

   Se si desidera scrivere una query che esegue query su più database, è necessario specificare nella query il database proprietario di ogni tabella.

   SELECT i_item_sk, country FROM sakila.country, ewd.item
   

5. L'ultima sezione del connettore Denodo è la modalità connettività dei dati, in cui è possibile scegliere tra modalità di importazione o modalità DirectQuery.

6. Al termine, selezionare OK.

7. Ora viene richiesta l'autenticazione. Il connettore personalizzato Denodo Power BI supporta tre tipi di autenticazione:

   • Windows: quando si sceglie di usare l'autenticazione di Windows, Power BI Desktop si connette a Virtual DataPort tramite l'autenticazione Kerberos.

     

     In questo caso:

     • L'autenticazione Kerberos deve essere abilitata nel server Virtual DataPort.

     • Il database Denodo Virtual DataPort a cui si connette l'origine dati deve essere configurato con l'opzione TIPO di autenticazione ODBC/ADO.net impostato su Kerberos.

     • Power BI Desktop deve essere in esecuzione nel dominio Windows, perché il driver ODBC richiede il ticket Kerberos dalla cache dei ticket del sistema operativo.

     • Assicurarsi che la pagina Opzioni avanzate della configurazione DSN contenga tutte le configurazioni necessarie per l'uso di Kerberos come metodo di autenticazione.

       

   • Basic: questo tipo di autenticazione connette Power BI Desktop ai dati Virtual DataPort tramite le credenziali del server Virtual DataPort.

     

     Annotazioni

     Le versioni precedenti del connettore Denodo richiedevano l'uso di caratteri di escape per determinati caratteri della password. A partire dalla versione 1.0.8, questa regola non è più necessaria.

   • Account aziendale: questo tipo di autenticazione connette Power BI Desktop ai dati Virtual DataPort tramite un set specifico di credenziali Microsoft. Questa opzione è una versione specializzata di OAuth per Microsoft Entra ID.

     

     Quando si seleziona Accedi, viene visualizzata una scheda di accesso. Immettere le credenziali Microsoft da usare per questa origine dati.

     

     Dopo aver eseguito l'accesso, selezionare Connetti. Viene quindi visualizzata la schermata del navigatore per la selezione della tabella.

     

     Annotazioni

     Per accedere ai database Virtual DataPort, è necessario creare un utente in Denodo. Il nome dell'utente deve corrispondere al messaggio di posta elettronica usato in Power BI quando l'utente accede all'account aziendale. Quando si crea l'utente in Denodo, è necessario selezionare EXTERNAL come tipo di autenticazione. Le autorizzazioni concesse a questo utente nei database Denodo determinano i database a cui è possibile accedere da Power BI Desktop.

8. Al termine, selezionare Connetti.

9. In Strumento di navigazione selezionare il database e i dati desiderati e quindi selezionare Carica. In alternativa, se si intende modificare i dati in ingresso, selezionare Trasforma dati.

   

Connettersi a un'origine dati ODBC dal servizio Power BI

Per questo metodo di connessione si usa il gateway dati locale. Segui questi passaggi:

1. Configurare il gateway dati locale (gateway aziendale). Questo gateway offre un trasferimento rapido e sicuro dei dati tra i dati locali (dati nell'applicazione Power BI Desktop, non nel cloud) e il servizio Power BI.

2. Accedi e registra il gateway. Nell'app gateway dati locale selezionare la scheda Stato per assicurarsi che il gateway sia online e pronto per l'uso.

   

3. Nel servizio Power BI, in Impostazioni origine dati, creare un'origine dati per il connettore personalizzato Denodo Power BI.

   

   Per creare l'origine dati, è necessario specificare il modo per connettersi all'origine dati desiderata:

   • DSN
   • stringa di connessione

   Annotazioni

   È consigliabile usare DSN. Offre molte opzioni di configurazione che potrebbero non essere direttamente disponibili quando si usa una stringa di connessione.

   È anche necessario specificare la modalità di autenticazione. I metodi di autenticazione disponibili sono:

   • Windows: il servizio Power BI si connette a Virtual DataPort tramite l'autenticazione Kerberos.

     • In Impostazioni origine dati immettere il nome utente e la password per creare il ticket Kerberos.
     • Nel server Virtual DataPort abilitare l'autenticazione Kerberos.
     • Il database Denodo Virtual DataPort a cui si connette l'origine dati deve essere configurato con l'opzione TIPO di autenticazione ODBC/ADO.net impostato su Kerberos.
     • Assicurarsi che la pagina Opzioni avanzate della configurazione DSN contenga tutte le configurazioni necessarie per l'uso di Kerberos come metodo di autenticazione.

     

   • Basic: è possibile creare un'origine dati nel servizio Power BI per connettersi ai dati Virtual DataPort tramite le credenziali del server Virtual DataPort.

   • Oauth: è possibile creare un'origine dati nel servizio Power BI per connettersi ai dati Virtual DataPort tramite le credenziali Microsoft.

     Annotazioni

     Per accedere ai database Virtual DataPort, è necessario creare un utente in Denodo il cui nome corrisponde al messaggio di posta elettronica usato in Power BI durante l'accesso all'account aziendale. Quando si crea l'utente in Denodo, è necessario selezionare EXTERNAL come tipo di autenticazione. Le autorizzazioni concesse a questo utente nei database Denodo determinano i database a cui è possibile accedere da Power BI.

4. Se si usa l'autenticazione di Windows, in Impostazioni avanzate per l'origine dati è possibile abilitare lo schema di autenticazione Single Sign-On (SSO). È quindi possibile usare le stesse credenziali dell'utente che accede ai report in Power BI per accedere ai dati necessari in Denodo.

   

   Sono disponibili due opzioni per l'abilitazione dell'accesso Single Sign-On: usare SSO tramite Kerberos per le query DirectQuery e Usare SSO tramite Kerberos per le query DirectQuery e Import. Se si usano report basati su DirectQuery, entrambe le opzioni usano le credenziali SSO dell'utente che accede al servizio Power BI. Se si usano report basati su Importa, l'opzione precedente usa le credenziali immesse nella pagina origine dati (campi Nome utente e password ), mentre quest'ultima usa le credenziali del proprietario del set di dati.

   Esistono particolari prerequisiti e considerazioni da tenere in considerazione per usare l'accesso SSO basato su Kerberos. Alcuni di questi requisiti sono:

   • È necessario abilitare la delega vincolata Kerberos per l'utente Windows che esegue il gateway Power BI. Configurare anche sia gli ambienti Active Directory locale che Microsoft Entra ID in base alle istruzioni offerte da Microsoft a questo scopo.

     Per impostazione predefinita, il gateway di Power BI invia il nome principale utente (UPN) quando esegue l'autenticazione SSO. È necessario verificare l'attributo utilizzato come identificatore di accesso nell'autenticazione Kerberos di Denodo. Se è diverso da userPrincipalName, modificare le impostazioni del gateway in base a questo valore.

   • Il file di configurazione di Power BI Gateway è Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, che si trova in \Program Files\On-premises data gateway. Questo file ha due proprietà, denominate ADUserNameLookupProperty e ADUserNameReplacementProperty, che consentono al gateway di eseguire ricerche di ID Entra locali in fase di esecuzione. ADUserNameLookupProperty deve specificare quale attributo dell'istanza locale di Active Directory deve mappare il nome principale utente che proviene dall'ID Microsoft Entra. Quindi, in questo scenario, ADUserNameLookupProperty deve essere userPrincipalName. Quindi, quando l'utente viene trovato, il ADUserNameReplacementProperty valore indica l'attributo che deve essere usato per autenticare l'utente rappresentato (l'attributo usato come identificatore di accesso in Denodo).

     Le modifiche apportate a questo file di configurazione sono a livello di gateway e queste modifiche influiscono su qualsiasi origine con cui viene eseguita l'autenticazione SSO tramite il gateway Power BI.

5. Dopo aver creato un'origine dati per il connettore Denodo, è possibile aggiornare i report di Power BI. Per pubblicare un report in powerbi.com:

   • Aprire il report in Power BI Desktop.
   • > Pubblica file in> Power BI.
   • Salvare il report nel computer.
   • Selezionare l'area di lavoro in cui si vuole pubblicare.

Configurazione avanzata

Uso del parametro ConnectionTimeout

Se si desidera controllare il tempo di attesa prima di abbandonare un tentativo di stabilire una connessione a un server, è possibile usare il ConnectionTimeout parametro .

Usare questo parametro solo dall'editor avanzato. A tale scopo, il ConnectionTimeout parametro deve essere aggiunto nelle opzioni del record, associando un valore di tipo duration .

Altre informazioni sul duration tipo in questo articolo.

Uso del parametro QueryTimeout

Se si desidera controllare il tempo di attesa prima di abbandonare un tentativo di esecuzione di una query, è possibile usare il QueryTimeout parametro .

Usare questo parametro solo dall'editor avanzato. A tale scopo, il QueryTimeout parametro deve essere aggiunto nelle opzioni del record, associando un valore di tipo number . Questo valore numerico è rappresentato in millisecondi (ad esempio, 10000 è uguale a 10 secondi).

Uso del parametro UserAgent

Se si vuole specificare il nome dell'applicazione client, è possibile usare il UserAgent parametro .

Usare questo parametro solo dall'editor avanzato. A tale scopo, il UserAgent parametro deve essere aggiunto nelle opzioni del record, associando un valore di tipo text.

Uso del parametro Compression

È consigliabile attivare questa impostazione quando l'applicazione client e il server Denodo sono connessi tramite una rete WAN. In questi casi, è possibile prevedere miglioramenti significativi delle prestazioni quando l'applicazione client legge volumi di dati moderati o di grandi dimensioni.

Usare questo parametro solo dall'editor avanzato. A tale scopo, il Compression parametro deve essere aggiunto nelle opzioni del record, associando un valore di tipo number (0 o 1).

Risoluzione dei problemi

Se una vista Denodo importata come origine dati in Power BI ha più di 42 relazioni con altre visualizzazioni, Power BI potrebbe visualizzare l'errore seguente quando si tenta di accedere alla finestra di trasformazione dei dati:

Preview.Error: The type of the current preview value is too complex to display.

Questo errore è dovuto a una limitazione nella piattaforma Power Query. Per risolvere il problema, selezionare l'origine dati non riuscita (query) nella finestra di trasformazione dei dati e selezionare Visualizza>Editor Avanzato. Modificare quindi l'espressione dell'origine dati nel linguaggio M, aggiungendo la proprietà seguente all'argomento options nella chiamata della funzione Denodo.Contents.

CreateNavigationProperties=false

La chiamata sarà quindi simile alla seguente:

  Source = Denodo.Contents(<dsn>, null, [CreateNavigationProperties=false])

Questa proprietà indica a Power BI di non provare a generare proprietà di navigazione dalle relazioni registrate per la visualizzazione Denodo a cui si accede in questa origine dati. Se è necessario che alcune di queste relazioni siano presenti nel modello di dati di Power BI, è necessario registrarle manualmente in seguito.