Connettore Looker-Tableau BI

Il connettore di BI Looker-Tableau ti consente di utilizzare un'esplorazione di Looker come origine dati in Tableau. Il connettore BI Looker-Tableau è basato sull'interfaccia Open SQL di Looker, che consente di accedere a modelli e esplorazioni LookML per le applicazioni che utilizzano JDBC per connettersi alle origini dati. Per ulteriori dettagli, consulta la documentazione dell'interfaccia Open SQL.

Prima di iniziare

L'istanza di Looker deve soddisfare i seguenti requisiti per utilizzare il connettore BI Looker-Tableau:

  • Eseguire Looker 24.14 o versioni successive.
  • Abilitato per il connettore BI di Tableau Desktop. Un amministratore di Looker deve attivare l'opzione di attivazione/disattivazione Tableau Desktop nella pagina Connettori BI di Looker.
  • Contiene un progetto LookML che utilizza i dati di una connessione Google BigQuery:
    • Il progetto LookML deve essere configurato in modo che il campo Connessioni consentite sia impostato sull'opzione Solo queste connessioni con almeno una connessione Google BigQuery selezionata. Per informazioni sulla configurazione di un modello e sulle connessioni consentite per il modello, consulta la pagina della documentazione Consultazione e modifica delle informazioni sui progetti.
    • Il progetto LookML deve avere un file model che specifichi una connessione BigQuery nel parametro connection.

Inoltre, ogni persona che utilizza il connettore BI Looker-Tableau deve disporre di un account Looker con un ruolo utente che includa l'autorizzazione explore per il modello LookML a cui vuole accedere da Tableau.

Configurare Tableau Desktop per connettersi a Looker

Una volta soddisfatti tutti i requisiti, puoi configurare Tableau Desktop per connettersi ai dati di Looker.

Ogni utente che vuole accedere al connettore BI di Looker e Tableau deve scaricare il file avatica-<release_number>-looker.jar e il file del connettore Tableau pacchettizzato (TACO), quindi salvarli in directory specifiche sul computer. Le sezioni seguenti forniscono istruzioni per scaricare questi file e dove posizionarli sul computer:

File del connettore Tableau (TACO)

Il file del connettore Tableau si chiama looker_v1.0.0.taco. Ogni utente deve scaricare il file TACO e salvarlo sul computer seguendo questa procedura:

  1. Per scaricare il file del connettore Tableau, fai clic sul seguente link: looker_v1.0.0.taco
  2. Al termine del download, sposta il file looker_v1.0.0.taco nella sottodirectory Connectors della directory My Tableau Repository. Di seguito sono riportati i percorsi delle directory predefinite:

    • Windows:

      C:\Users\\Windows user\Documents\My Tableau Repository\Connectors
      
    • MacOS:

      /Users/Mac user/Documents/My Tableau Repository/Connectors
      

File del driver JDBC (looker.jar)

Il driver JDBC si chiama avatica-<release_number>-looker.jar. Ogni utente deve scaricare il file looker.jar da GitHub e salvarlo sul computer seguendo questi passaggi:

  1. Vai alla pagina https://github.com/looker-open-source/calcite-avatica/releases.
  2. Scarica la versione più recente del file avatica-<release_number>-looker.jar.
  3. Salva il file avatica-<release_number>-looker.jar sul computer di ciascun utente nella seguente posizione:

    • Windows: C:\Program Files\Tableau\Drivers
    • MacOS: /Library/JDBC o ~/Library/JDBC

Connessione ai dati di Looker da Tableau Desktop

Dopo aver scaricato e salvato i file looker_v1.0.0.taco e avatica-<release_number>-looker.jar, puoi utilizzare Tableau Desktop per connetterti ai dati dell'istanza di Looker seguendo questi passaggi:

  1. In Tableau Desktop, seleziona l'opzione Altro… nella sezione A un server del riquadro Connetti a sinistra.
  2. Nella casella di ricerca, inserisci Looker di Google.
  3. Seleziona l'opzione Looker di Google.
  4. Nella finestra di dialogo, inserisci i seguenti parametri:
    • Server: inserisci l'URL dell'istanza di Looker senza https://. Ad esempio: example.cloud.looker.com
    • Porta: 443
    • Autenticazione: OAuth
    • URL istanza OAuth: inserisci l'URL completo dell'istanza Looker con https://. Ad esempio: https://example.cloud.looker.com
  5. Seleziona Accedi. Tableau aprirà una finestra del browser per connettersi all'istanza di Looker e autenticare il tuo account con OAuth.
  6. Se richiesto, accedi a Looker. Se hai già eseguito l'accesso, nella finestra del browser viene visualizzato un messaggio che indica che Tableau ha utilizzato la finestra del browser per autenticarsi in Looker e che ora puoi chiuderla.
  7. Dopo aver eseguito l'autenticazione in Looker, Tableau aprirà una pagina Origine dati con una connessione all'istanza di Looker.
  8. Utilizza il menu a discesa Schema per selezionare un modello di Looker con i dati che vuoi visualizzare in Tableau Desktop. Tableau compila l'elenco Table con le esplorazioni di Looker del modello di Looker selezionato.
  9. Per iniziare a esplorare i dati, seleziona e trascina un oggetto dall'elenco Tables (Tabelle) nel canvas.

Identificare le query del connettore BI di Looker e Tableau nell'interfaccia utente di Looker

Le query da Tableau vengono eseguite tramite l'interfaccia Open SQL. Gli amministratori di Looker possono utilizzare l'interfaccia utente di Looker per identificare le query originate dall'interfaccia Open SQL, come descritto nella documentazione dell'interfaccia Open SQL.

Le query del connettore BI Looker-Tableau hanno un valore Origine pari a "sql_interface" o "SQL Interface".

Utilizzare il connettore BI Looker-Tableau su Tableau Server

Il connettore BI Looker-Tableau non è disponibile su Tableau Exchange, ma puoi installarlo su Tableau Server seguendo le procedure descritte nelle sezioni seguenti:

Prima di iniziare

L'istanza di Looker deve soddisfare i seguenti requisiti per utilizzare il connettore BI Looker-Tableau su Tableau Server:

  • Eseguire Looker 24.14 o versioni successive.
  • Contiene un progetto LookML che utilizza i dati di una connessione Google BigQuery:
    • Il progetto LookML deve essere configurato in modo che il campo Connessioni consentite sia impostato sull'opzione Solo queste connessioni con almeno una connessione Google BigQuery selezionata. Per informazioni sulla configurazione di un modello e sulle connessioni consentite per il modello, consulta la pagina della documentazione Consultazione e modifica delle informazioni sui progetti.
    • Il progetto LookML deve avere un file model che specifichi una connessione BigQuery nel parametro connection.

Inoltre, ogni persona che utilizza il connettore BI Looker-Tableau deve avere un account Looker con un ruolo utente che includa l'autorizzazione explore per il modello LookML a cui vuole accedere da Tableau.

Configurare OAuth per il connettore BI Looker-Tableau

Per utilizzare il connettore BI Looker-Tableau per Tableau Server, devi configurare l'integrazione OAuth nell'istanza di Looker.

Puoi utilizzare Explorer API di Looker per configurare l'integrazione di OAuth per il connettore BI Looker-Tableau:

  • Se nella tua istanza Looker è già installato Explorer API, puoi accedervi con questo formato URL:

    https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
    
  • Se la tua istanza di Looker non dispone di API Explorer, puoi installarla dal marketplace di Looker. Per informazioni, consulta la pagina Utilizzare Explorer API.

Per utilizzare API Explorer per configurare l'integrazione di OAuth nell'istanza di Looker:

  1. Apri Explorer API di Looker (per informazioni, consulta la pagina Utilizzare Explorer API).
  2. Nel campo Cerca di Explorer API, inserisci Registra app OAuth.
  3. Nei risultati di ricerca, fai clic su Registra app OAuth.
  4. Nella pagina Registra app OAuth, fai clic sul pulsante Esegui.
  5. Nella scheda Richiesta della finestra di dialogo Esegui, inserisci le seguenti informazioni nei campi corrispondenti:

    • client_guid:
    tableau-server
    
    • body:
    {
      "redirect_uri": TABLEAU_SERVER_INSTANCE_URL/auth/add_oauth_token,
      "display_name": "Looker-Tableau-Server (manual)",
      "description": "Client for Looker-Tableau Server integration (manually added)",
      "enabled": true,
      "group_id": ""
    }
    
  6. Seleziona la casella di controllo Sono consapevole che questo endpoint API modificherà i dati.

  7. Fai clic su Esegui.

  8. Puoi verificare di aver configurato correttamente l'autenticazione utilizzando il metodo Get OAuth Client App in API Explorer:

    • Nel campo Cerca di Explorer API, inserisci Ottieni app client OAuth.
    • Fai clic su Esegui.
    • Nel campo client_guid, inserisci questo valore: tableau-server

    Se configuri OAuth correttamente, la scheda Risposta restituirà i valori inseriti durante la registrazione dell'app.

Installa il connettore BI Looker-Tableau su Tableau Server

Per installare il connettore BI di Looker-Tableau su Tableau Server, segui questi passaggi:

  1. Scarica il file del connettore Tableau facendo clic sul seguente link: looker_v1.0.0.taco
  2. Scarica la versione più recente del file avatica-<release_number>-looker.jar da https://github.com/looker-open-source/calcite-avatica/releases.
  3. Installa i file TACO e JAR sulla macchina host di Tableau Server. La posizione dei file dipende dal sistema operativo del server. I percorsi di installazione di Tableau predefiniti sono riportati nella tabella seguente:
Posizione del file TACO Posizione del file JAR
Server Linux
/opt/tableau/connectors
/opt/tableau/tableau_driver/jdbc
Server Windows
C:\Program Files\Tableau\Connectors
C:\Program Files\Tableau\Drivers

Completa la configurazione su Tableau Server

Dopo aver configurato OAuth per il connettore BI Looker-Tableau e installato il connettore BI Looker-Tableau, puoi completare la configurazione eseguendo le seguenti procedure sulla macchina host di Tableau Server:

Aspetti da considerare

Quando esamini i dati di Looker con Tableau Desktop, tieni presente le seguenti considerazioni:

  • Il connettore Looker-Tableau BI è basato sull'interfaccia Open SQL di Looker e presenta le stesse limitazioni di LookML e SQL dell'interfaccia Open SQL. Per ulteriori dettagli, consulta la documentazione dell'interfaccia Open SQL.
  • Tableau esegue automaticamente una query sul database ogni volta che viene apportata una modifica alla query, ad esempio quando i campi vengono aggiunti e rimossi utilizzando il connettore BI di Looker a Tableau. Puoi disattivare gli aggiornamenti automatici in Tableau: consulta la documentazione di Tableau per ulteriori informazioni.
  • Non puoi utilizzare Tableau per unire due esplorazioni di Looker. Se vuoi unire le esplorazioni, utilizza Looker per creare le unioni nel tuo modello Looker. Per informazioni sull'utilizzo delle unioni in Looker, consulta le pagine della documentazione di Looker Utilizzo delle unioni in LookML e Parametri di join.
  • Il connettore BI di Looker e Tableau è progettato per funzionare con una connessione in tempo reale in Tableau. La modalità di estrazione dei dati di Tableau estrae le misure di Looker con un valore "null" e, pertanto, non produrrà risultati accurati. Se vuoi utilizzare la modalità di estrazione, puoi creare campi aggregati in Tableau direttamente dai campi delle dimensioni di Looker anziché utilizzare le misure di Looker.

Eseguire l'upgrade dall'anteprima pubblica del connettore BI Looker-Tableau

Se hai partecipato all'anteprima pubblica del connettore BI Looker-Tableau, la configurazione esistente continuerà a funzionare così com'è. Tuttavia, ti consigliamo di eseguire l'upgrade alla versione più recente del connettore BI Looker-Tableau.

Per eseguire l'upgrade alla versione più recente del connettore BI di Looker e Tableau, un amministratore di Looker deve svolgere le seguenti attività:

  1. Verifica che l'istanza di Looker soddisfi i requisiti.
  2. Nell'istanza di Looker, attiva l'opzione di attivazione/disattivazione Tableau Desktop nella pagina Connettori BI.

Dopo che un amministratore di Looker ha attivato l'opzione di attivazione/disattivazione Tableau Desktop nell'istanza di Looker, gli utenti dell'istanza di Looker possono procedere nel seguente modo per utilizzare il connettore BI Looker-Tableau più recente:

Dopo aver scaricato e salvato sia il file del connettore Tableau sia il file del driver JDBC, l'utente può collegarsi ai dati di Looker da Tableau Desktop. Gli utenti dovranno autenticarsi nel proprio account Looker nel connettore BI Looker-Tableau di cui è stato eseguito l'upgrade.

Una volta che tutti gli utenti dell'istanza di Looker hanno eseguito l'upgrade al nuovo connettore BI Looker-Tableau, puoi seguire la procedura per rimuovere l'app OAuth di Tableau che hai aggiunto all'istanza di Looker nell'ambito della configurazione per l'anteprima pubblica.

Rimozione dell'app OAuth di Tableau (facoltativa)

Questa procedura non è obbligatoria. Tuttavia, una volta che tutti gli utenti dell'istanza di Looker hanno eseguito l'upgrade al file del connettore looker_v1.0.0.taco Tableau, puoi rimuovere la versione di anteprima privata dell'app OAuth di Tableau dall'istanza di Looker seguendo questi passaggi:

  1. Apri Explorer API di Looker (per informazioni, consulta la pagina Utilizzare Explorer API).
  2. Nel campo Cerca di API Explorer, inserisci Elimina app client OAuth.
  3. Nei risultati di ricerca, fai clic su Elimina app client OAuth.
  4. Nella pagina Elimina app client OAuth, fai clic sul pulsante Esegui.
  5. Nella scheda Richiesta della finestra di dialogo Esegui, inserisci il valore client_guid dell'app OAuth di Tableau. Per la versione del connettore BI Looker-Tableau di Anteprima pubblica (v0.2.0), il valore client_guid è:

      35FBB268-0CB0-4822-AFE3-28638C1C6269
    
  6. Seleziona la casella di controllo Sono consapevole che questo endpoint API modificherà i dati.

  7. Puoi verificare di aver rimosso correttamente l'app OAuth di Tableau utilizzando il metodo Get OAuth Client App in Explorer API:

    • Nel campo Cerca di Explorer API, inserisci Ottieni app client OAuth.
    • Fai clic su Esegui.
    • Nel campo client_guid, inserisci il valore dell'app OAuth di Tableau: 35FBB268-0CB0-4822-AFE3-28638C1C6269

    Se hai rimosso correttamente l'app OAuth di Tableau, la scheda Risposta restituirà valori del corpo vuoti.