Looker-Tableau-BI-Connector

Mit dem Looker-Tableau-BI-Connector können Sie ein Looker-Explore als Datenquelle in Tableau verwenden. Der Looker-Tableau-BI-Connector basiert auf der Looker Open SQL-Schnittstelle, die Anwendungen, die über JDBC eine Verbindung zu Datenquellen herstellen, den Zugriff auf LookML-Modelle und Explores ermöglicht. Weitere Informationen finden Sie in der Open SQL Interface-Dokumentation.

Hinweise

Ihre Looker-Instanz muss die folgenden Anforderungen erfüllen, damit Sie den Looker-Tableau-BI-Connector verwenden können:

  • Sie verwenden Looker 24.14 oder höher.
  • Aktiviert für den BI-Connector Tableau Desktop. Ein Looker-Administrator muss die Option Tableau Desktop auf der Seite BI-Connectors aktivieren.
  • Enthält ein LookML-Projekt, das Daten aus einer Google BigQuery-Verbindung verwendet:
    • Das LookML-Projekt muss so konfiguriert sein, dass für das Feld Zulässige Verbindungen die Option Nur diese Verbindungen ausgewählt ist und mindestens eine Google BigQuery-Verbindung ausgewählt ist. Informationen zum Konfigurieren eines Modells und zu den zulässigen Verbindungen für das Modell finden Sie auf der Dokumentationsseite Auf Projektinformationen zugreifen und sie bearbeiten.
    • Das LookML-Projekt muss eine Modelldatei haben, die im Parameter connection eine BigQuery-Verbindung angibt.

Außerdem muss jede Person, die den Looker-Tableau-BI-Connector verwendet, ein Looker-Konto mit einer Nutzerrolle haben, die die Berechtigung explore für das LookML-Modell enthält, auf das sie über Tableau zugreifen möchte.

Tableau Desktop für die Verbindung mit Looker einrichten

Sobald alle Anforderungen erfüllt sind, können Sie Tableau Desktop so einrichten, dass eine Verbindung zu Looker-Daten hergestellt wird.

Jeder Nutzer, der auf den Looker-Tableau-BI-Connector zugreifen möchte, muss die avatica-<release_number>-looker.jar-Datei und die TACO-Datei (verpackter Tableau-Connector) herunterladen und dann in bestimmten Verzeichnissen auf seinem Computer speichern. In den folgenden Abschnitten finden Sie eine Anleitung zum Herunterladen dieser Dateien und dazu, wo Sie sie auf Ihrem Computer speichern können:

Tableau-Connector-Datei (TACO)

Die Tableau-Connectordatei heißt looker_v1.0.0.taco. Jeder Nutzer muss die TACO-Datei herunterladen und auf seinem Computer speichern. Gehen Sie dazu so vor:

  1. Klicken Sie auf den folgenden Link, um die Tableau-Connectordatei herunterzuladen: looker_v1.0.0.taco

  2. Verschieben Sie die Datei looker_v1.0.0.taco nach Abschluss des Downloads in das Unterverzeichnis Connectors des Verzeichnisses My Tableau Repository. Hier sind die Standardverzeichnispfade:

    • Windows:

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

    • MacOS:

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

JDBC-Treiberdatei (looker.jar)

Der JDBC-Treiber heißt avatica-<release_number>-looker.jar. Jeder Nutzer muss die looker.jar-Datei von GitHub herunterladen und auf seinem Computer speichern. Gehen Sie dazu so vor:

  1. Rufen Sie https://github.com/looker-open-source/calcite-avatica/releases auf.
  2. Laden Sie die neueste Version der Datei avatica-<release_number>-looker.jar herunter.

  3. Speichern Sie die Datei avatica-<release_number>-looker.jar auf dem Computer jedes Nutzers an folgendem Speicherort:

    • Windows: C:\Program Files\Tableau\Drivers

    • MacOS: /Library/JDBC oder ~/Library/JDBC

Verbindung zu Looker-Daten von Tableau Desktop herstellen

Nachdem Sie die Dateien looker_v1.0.0.taco und avatica-<release_number>-looker.jar heruntergeladen und gespeichert haben, können Sie mit Tableau Desktop eine Verbindung zu den Daten Ihrer Looker-Instanz herstellen. Gehen Sie dazu so vor:

  1. Wählen Sie in Tableau Desktop im linken Bereich Verbinden im Abschnitt Mit einem Server die Option Mehr… aus.
  2. Geben Sie Looker by Google in das Suchfeld ein.
  3. Wählen Sie die Option Looker by Google aus.
  4. Geben Sie im Dialogfeld die folgenden Parameter ein:
    • Server: Geben Sie die URL der Looker-Instanz ohne https:// ein. Beispiel: example.cloud.looker.com
    • Port: 443
    • Authentifizierung: OAuth
    • OAuth-Instanz-URL: Geben Sie die vollständige URL der Looker-Instanz mit der https:// ein. Beispiel: https://example.cloud.looker.com
  5. Wähle Anmelden. Tableau öffnet ein Browserfenster, um eine Verbindung zu Ihrer Looker-Instanz herzustellen und Ihr Konto mit OAuth zu authentifizieren.
  6. Melden Sie sich in Looker an, wenn Sie dazu aufgefordert werden. Wenn Sie bereits angemeldet sind, wird im Browserfenster eine Meldung angezeigt, dass Tableau das Browserfenster verwendet hat, um sich in Looker zu authentifizieren, und dass Sie das Browserfenster jetzt schließen können.
  7. Nachdem Sie sich in Looker authentifiziert haben, wird in Tableau die Seite Datenquelle mit einer Verbindung zu Ihrer Looker-Instanz geöffnet.
  8. Wählen Sie im Drop-down-Menü Schema ein Looker-Modell mit den Daten aus, die Sie in Tableau Desktop aufrufen möchten. In Tableau werden die Looker-Explores aus dem ausgewählten Looker-Modell in die Liste Tabelle eingefügt.
  9. Wenn Sie die Daten untersuchen möchten, wählen Sie ein Objekt aus der Liste Tabellen aus und ziehen Sie es auf den Canvas.

Looker-Tableau-BI-Connector-Abfragen in der Looker-Benutzeroberfläche identifizieren

Abfragen aus Tableau werden über die Open SQL-Schnittstelle gesendet. Looker-Administratoren können in der Looker-Benutzeroberfläche sehen, welche Abfragen von der Open SQL Interface stammen, wie in der Open SQL Interface-Dokumentation beschrieben.

Abfragen vom Looker-Tableau-BI-Connector haben den Wert „sql_interface“ oder „SQL-Schnittstelle“ für Quelle.

Looker-Tableau-BI-Connector auf Tableau Server verwenden

Der Looker-Tableau-BI-Connector ist nicht auf der Tableau Exchange verfügbar. Sie können ihn aber auf Tableau Server installieren. Folgen Sie dazu der Anleitung in den folgenden Abschnitten:

Hinweise

Ihre Looker-Instanz muss die folgenden Anforderungen erfüllen, damit Sie den Looker-Tableau-BI-Connector auf dem Tableau-Server verwenden können:

  • Sie verwenden Looker 24.14 oder höher.
  • Enthält ein LookML-Projekt, das Daten aus einer Google BigQuery-Verbindung verwendet:
    • Das LookML-Projekt muss so konfiguriert sein, dass für das Feld Zulässige Verbindungen die Option Nur diese Verbindungen ausgewählt ist und mindestens eine Google BigQuery-Verbindung ausgewählt ist. Informationen zum Konfigurieren eines Modells und zu den zulässigen Verbindungen für das Modell finden Sie auf der Dokumentationsseite Auf Projektinformationen zugreifen und sie bearbeiten.
    • Das LookML-Projekt muss eine Modelldatei haben, die im Parameter connection eine BigQuery-Verbindung angibt.

Außerdem muss jede Person, die den Looker-Tableau-BI-Connector verwendet, ein Looker-Konto mit einer Nutzerrolle haben, die die Berechtigung explore für das LookML-Modell enthält, auf das sie über Tableau zugreifen möchte.

OAuth für den Looker-Tableau-BI-Connector einrichten

Wenn Sie den Looker-Tableau-BI-Connector für Tableau Server verwenden möchten, müssen Sie die OAuth-Integration in Ihrer Looker-Instanz einrichten.

Mit dem API Explorer von Looker können Sie die OAuth-Integration für den Looker-Tableau-BI-Connector einrichten:

  • Wenn in Ihrer Looker-Instanz bereits der API Explorer installiert ist, können Sie über dieses URL-Format darauf zugreifen:

    https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

  • Wenn in Ihrer Looker-Instanz kein API Explorer installiert ist, können Sie ihn über den Looker Marketplace installieren. Weitere Informationen finden Sie auf der Seite API Explorer verwenden.

So richten Sie mit dem API Explorer die OAuth-Integration in Ihrer Looker-Instanz ein:

  1. Öffnen Sie den Looker API Explorer. Weitere Informationen finden Sie auf der Seite API Explorer verwenden.
  2. Geben Sie im Feld Suchen des API Explorers OAuth-App registrieren ein.
  3. Klicken Sie in den Suchergebnissen auf OAuth-App registrieren.
  4. Klicken Sie auf der Seite OAuth-App registrieren auf die Schaltfläche Ausführen.

  5. Geben Sie im Dialogfeld Ausführen auf dem Tab Anfrage die folgenden Informationen in die entsprechenden Felder ein:

    • 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. Setzen Sie ein Häkchen in das Kästchen Ich weiß, dass durch diesen API-Endpunkt Daten geändert werden.

  7. Klicken Sie auf Ausführen.

  8. Mit der Methode Get OAuth Client App im API Explorer können Sie prüfen, ob die Authentifizierung erfolgreich eingerichtet wurde:

    • Geben Sie im Feld Suchen des API Explorers OAuth-Client-App abrufen ein.
    • Klicken Sie auf Ausführen.
    • Geben Sie im Feld client_guid den folgenden Wert ein: tableau-server

    Wenn Sie OAuth erfolgreich eingerichtet haben, werden auf dem Tab Antwort die Werte zurückgegeben, die Sie bei der Registrierung der App eingegeben haben.

Looker-Tableau-BI-Connector auf Tableau Server installieren

So installieren Sie den Looker-Tableau-BI-Connector auf Tableau Server:

  1. Laden Sie die Tableau-Connectordatei über den folgenden Link herunter: looker_v1.0.0.taco
  2. Laden Sie die neueste Version der Datei avatica-<release_number>-looker.jar unter https://github.com/looker-open-source/calcite-avatica/releases herunter.
  3. Installieren Sie die TACO- und JAR-Dateien auf dem Hostcomputer von Tableau Server. Der Speicherort der Dateien hängt vom Betriebssystem des Servers ab. Die Standardinstallationspfade für Tableau sind in der folgenden Tabelle aufgeführt:
Speicherort der TACO-Datei Speicherort der JAR-Datei
Linux-Server 
/opt/tableau/connectors

/opt/tableau/tableau_driver/jdbc
Windows-Server 
C:\Program Files\Tableau\Connectors

C:\Program Files\Tableau\Drivers

Einrichtung auf Tableau Server abschließen

Nachdem Sie OAuth für den Looker-Tableau-BI-Connector eingerichtet und den Looker-Tableau-BI-Connector installiert haben, können Sie die Einrichtung mit den folgenden Schritten auf dem Tableau-Server-Hostcomputer abschließen:

Wichtige Punkte

Beachten Sie beim Analysieren von Looker-Daten mit Tableau Desktop Folgendes:

  • Der Looker-Tableau-BI-Connector basiert auf der Looker Open SQL-Schnittstelle und unterliegt denselben LookML- und SQL-Einschränkungen wie die Open SQL-Schnittstelle. Weitere Informationen finden Sie in der Open SQL Interface-Dokumentation.
  • Tableau fragt die Datenbank automatisch ab, wenn eine Änderung an der Abfrage vorgenommen wird, z. B. wenn Felder über den Looker-Tableau-BI-Connector hinzugefügt oder entfernt werden. Sie können automatische Updates in Tableau deaktivieren. Weitere Informationen finden Sie in der Tableau-Dokumentation.
  • Sie können in Tableau keine zwei Looker-Explores zusammenführen. Wenn Sie Explores zusammenführen möchten, erstellen Sie die Zusammenführungen in Looker in Ihrem Looker-Modell. Informationen zur Verwendung von Joins in Looker finden Sie auf den Looker-Seiten Mit Joins in LookML arbeiten und Join-Parameter.
  • Der Looker-Tableau-BI-Connector ist für die Verwendung mit einer Liveverbindung in Tableau konzipiert. Im Datenextraktionsmodus von Tableau werden Looker-Messwerte mit dem Wert „null“ extrahiert. Daher werden keine genauen Ergebnisse erzielt. Wenn Sie den Extraktmodus verwenden möchten, können Sie in Tableau Summensätze direkt aus den Looker-Dimensionsfeldern erstellen, anstatt Looker-Messwerte zu verwenden.

Von der öffentlichen Vorschau des Looker-Tableau-BI-Connectors auf die allgemeine Verfügbarkeit umstellen

Wenn Sie an der öffentlichen Vorabversion des Looker-Tableau-BI-Connectors teilgenommen haben, funktioniert Ihre vorhandene Einrichtung weiterhin wie gewohnt. Wir empfehlen Ihnen jedoch, auf die neueste Version des Looker-Tableau-BI-Connectors zu aktualisieren.

Um auf die neueste Version des Looker-Tableau-BI-Connectors umzustellen, muss ein Looker-Administrator die folgenden Aufgaben ausführen:

  1. Prüfen Sie, ob die Looker-Instanz die Anforderungen erfüllt.
  2. Aktivieren Sie in der Looker-Instanz auf der Seite BI-Connectors die Option Tableau Desktop.

Nachdem ein Looker-Administrator die Ein/Aus-Schaltfläche für Tableau Desktop in der Looker-Instanz aktiviert hat, können die Nutzer der Looker-Instanz so den neuesten Looker-Tableau-BI-Connector verwenden:

Nachdem ein Nutzer sowohl die Tableau-Connector-Datei als auch die JDBC-Treiberdatei heruntergeladen und gespeichert hat, kann er eine Verbindung zu Looker-Daten von Tableau Desktop herstellen. Nutzer müssen sich im aktualisierten Looker-Tableau-BI-Connector in ihrem Looker-Konto authentifizieren.

Sobald alle Nutzer Ihrer Looker-Instanz auf den neuen Looker-Tableau-BI-Connector umgestellt haben, können Sie die Tableau-OAuth-App entfernen, die Sie Ihrer Looker-Instanz im Rahmen der Einrichtung der öffentlichen Vorabversion hinzugefügt haben.

Tableau OAuth-App entfernen (optional)

Dieser Vorgang ist nicht erforderlich. Sobald alle Nutzer Ihrer Looker-Instanz auf die looker_v1.0.0.taco-Tabellen-Connectordatei umgestiegen sind, können Sie die Version der Tableau OAuth-App für die private Vorschau aus Ihrer Looker-Instanz entfernen. Gehen Sie dazu so vor:

  1. Öffnen Sie den Looker API Explorer. Weitere Informationen finden Sie auf der Seite API Explorer verwenden.
  2. Geben Sie im Feld Suchen des API Explorers OAuth-Client-App löschen ein.
  3. Klicken Sie in den Suchergebnissen auf OAuth-Client-App löschen.
  4. Klicken Sie auf der Seite OAuth-Client-App löschen auf die Schaltfläche Ausführen.

  5. Geben Sie auf dem Tab Anfrage des Dialogfelds Ausführen den Wert client_guid der Tableau-OAuth-App ein. Für die öffentliche Vorabversion des Looker-Tableau-BI-Connectors (Version 0.2.0) lautet der Wert für client_guid:

      35FBB268-0CB0-4822-AFE3-28638C1C6269

  6. Setzen Sie ein Häkchen bei Ich weiß, dass durch diesen API-Endpunkt Daten geändert werden.

  7. Sie können mit der Get OAuth Client App-Methode im API Explorer prüfen, ob die Tableau OAuth-App entfernt wurde:

    • Geben Sie im Feld Suchen des API Explorers OAuth-Client-App abrufen ein.
    • Klicken Sie auf Ausführen.
    • Geben Sie im Feld client_guid den Wert der Tableau-OAuth-App ein: 35FBB268-0CB0-4822-AFE3-28638C1C6269.

    Wenn Sie die Tableau OAuth-App erfolgreich entfernt haben, werden auf dem Tab Antwort leere Body-Werte zurückgegeben.