Looker-Connettore Tableau (anteprima pubblica)

Il connettore Looker-Tableau consente di utilizzare Tableau Desktop per connetterti ai dati da un'esplorazione di Looker. Il connettore Looker-Tableau si basa sull'interfaccia open SQL di Looker, che consente di accedere a modelli ed esplorazioni LookML per le applicazioni che utilizzano JDBC per la connessione alle origini dati. Per ulteriori dettagli, consulta la documentazione sull'interfaccia Open SQL.

Questa guida si riferisce all'anteprima pubblica del connettore Looker-Tableau. Per fare domande o condividere feedback, invia un'email all'indirizzo tableau-looker@google.com.

Requisiti

Per utilizzare il connettore Looker-Tableau sono necessari i seguenti componenti:

Prima di configurare il connettore Looker-Tableau, devi inoltre completare i seguenti passaggi:

Configurazione di Tableau Desktop per la connessione a Looker in corso...

Per utilizzare il connettore Looker-Tableau in Anteprima pubblica, devi:

  1. Aggiungi l'app OAuth di Tableau all'istanza di Looker: un amministratore di Looker deve utilizzare l'API Looker per registrare l'app OAuth di Tableau per il connettore Looker-Tableau sulla tua istanza di Looker. L'app OAuth di Tableau deve essere registrata una sola volta per ogni istanza di Looker e si applica a tutti gli utenti nell'istanza di Looker.
  2. Scarica e salva il file del connettore Tableau e il file del driver JDBC: ogni utente che vuole accedere al connettore Looker-Tableau deve scaricare il file avatica-<release_number>-looker.jar e il file del connettore Tableau (.taco) in pacchetto, quindi salvare i file in directory specifiche sul proprio computer.

Le sezioni seguenti descrivono in dettaglio questi passaggi.

Aggiungi l'app OAuth Tableau all'istanza di Looker

Il connettore Looker-Tableau richiede la presenza dell'app OAuth di Tableau sulla tua istanza Looker. Il modo più semplice per registrare l'app OAuth di Tableau sulla tua istanza di Looker è tramite Explorer API di Looker.

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

https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/

Se la tua istanza di Looker non dispone di Explorer API, puoi installarlo da Looker Marketplace. Per informazioni, consulta la pagina Utilizzo di Explorer API.

Utilizza Explorer API per registrare l'app OAuth di Tableau sulla tua istanza Looker, come descritto nei passaggi seguenti:

  1. Apri Explorer API di Looker (per informazioni, consulta la pagina Utilizzo di 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 Request (Richiesta) della finestra di dialogo Run It (Esegui), inserisci le seguenti informazioni nei campi corrispondenti:

    • client_guid:

      35FBB268-0CB0-4822-AFE3-28638C1C6269
      
    • body:

      {
      "redirect_uri": "http://localhost:55556/Callback",
      "display_name": "Tableau Desktop",
      "description": "Tableau Desktop client for JDBC Server",
      "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 registrato 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 registrato correttamente l'app OAuth di Tableau, la scheda Risposta restituirà i valori inseriti al momento della registrazione dell'app.

Questo passaggio non è obbligatorio. Tuttavia, se in futuro non utilizzerai più il connettore Looker-Tableau e vuoi rimuovere l'app OAuth di Tableau, consulta Rimuovere l'app OAuth.

Scaricare e salvare i file del connettore

Per utilizzare il connettore Looker-Tableau, ogni utente di Tableau deve scaricare questi due file:

Le seguenti sezioni forniscono istruzioni per scaricare questi file e dove inserirli sul computer.

File del connettore Tableau (.taco)

Il file del connettore Tableau è denominato looker-jdbc-v0.2.0.taco. Ogni utente deve scaricare il file .taco e salvarlo sul proprio computer seguendo questi passaggi:

  1. Per scaricare il file del connettore Tableau, fai clic sul seguente link: looker-jdbc-v0.2.0.taco.
  2. Al termine del download, sposta il file looker-jdbc-v0.2.0.taco nella sottodirectory Connectors della directory My Tableau Repository. Ecco i percorsi predefiniti della directory:

    • Windows: C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors
    • MacOS: /Users/[user]/Documents/My Tableau Repository/Connectors

File del driver JDBC (looker.jar)

Il driver JDBC è denominato avatica-<release_number>-looker.jar. Ogni utente deve scaricare il file looker.jar da GitHub e salvare il file sul proprio 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 aggiunto l'app OAuth di Tableau all'istanza di Looker e scaricato i file looker-jdbc-v0.2.0.taco e avatica-<release_number>-looker.jar, puoi utilizzare Tableau Desktop per connetterti ai dati dell'istanza di Looker seguendo questa procedura:

  1. In Tableau Desktop, nel riquadro Connetti a sinistra, nella sezione A un server, seleziona l'opzione Altro....
  2. Nella casella di ricerca, inserisci Looker JDBC di Google.
  3. Seleziona l'opzione Looker JDBC 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 di Looker con il campo https://. Ad esempio: https://example.cloud.looker.com
  5. Seleziona Accedi. Tableau aprirà una finestra del browser per connettersi alla tua istanza Looker e autenticare il tuo account con OAuth.
  6. Se richiesto, inserisci le tue credenziali OAuth. Se hai già eseguito l'accesso, nella finestra del browser verrà visualizzato un messaggio che indica che Tableau ha utilizzato la finestra del browser per l'autenticazione in Looker e che ora puoi chiudere la finestra del browser.
  7. Dopo aver eseguito l'autenticazione in Looker, Tableau aprirà una pagina Origine dati con una connessione alla tua istanza Looker.
  8. Utilizza il menu a discesa Schema per selezionare un model Looker con i dati che vuoi visualizzare in Tableau Desktop. Tableau completerà l'elenco Table con le esplorazioni di Looker del modello Looker che hai selezionato.
  9. Per iniziare a esplorare i dati, seleziona e trascina un oggetto dall'elenco Tabelle al canvas.

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

Le query da Tableau vengono effettuate tramite l'interfaccia Open SQL. Gli amministratori di Looker possono utilizzare l'interfaccia utente di Looker per identificare le query che hanno avuto origine dall'interfaccia Open SQL, come descritto nella documentazione sull'interfaccia Open SQL.

Le query del connettore Looker-Tableau hanno un valore Source pari a "sql_interface" o "Interfaccia SQL".

Aspetti da considerare

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

  • Il connettore Looker-Tableau si basa sull'interfaccia Open SQL di Looker e presenta le stesse limitazioni LookML dell'interfaccia Open SQL. Per ulteriori dettagli, consulta la documentazione sull'interfaccia Open SQL.
  • Tableau esegue automaticamente una query nel database ogni volta che viene apportata una modifica alla query, anche quando i campi vengono aggiunti e rimossi utilizzando il connettore Looker-Tableau. Puoi disattivare gli aggiornamenti automatici in Tableau. Per ulteriori informazioni, consulta la documentazione di Tableau.
  • Non puoi utilizzare Tableau per unire due esplorazioni di Looker. Se vuoi unire le esplorazioni, utilizza Looker per creare i join nel modello Looker. Consulta le pagine della documentazione di Looker sull'utilizzo dei join in LookML e sui parametri di join per informazioni sull'utilizzo dei join in Looker.

Per segnalare un bug

Per segnalare un bug, invia un'email all'indirizzo tableau-looker@google.com e includi le seguenti informazioni:

  • Un elenco dettagliato dei passaggi seguiti
  • Il comportamento previsto
  • Il comportamento effettivo (se possibile, con uno screenshot)

Rimozione dell'app OAuth di Tableau (facoltativo)

Questo passaggio non è obbligatorio. Tuttavia, se in futuro non utilizzi più il connettore Looker-Tableau e vuoi rimuovere l'app OAuth di Tableau dalla tua istanza di Looker, puoi utilizzare Explorer API seguendo questa procedura:

  1. Apri Explorer API di Looker (per informazioni, consulta la pagina Utilizzo di Explorer API).
  2. Nel campo Cerca di Explorer API, 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 Request (Richiesta) della finestra di dialogo Run It (Esegui it), inserisci il valore client_guid dell'app OAuth di Tableau:

    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 di corpo vuoti.