Looker-Tableau-Connector (öffentliche Vorschau)

Mit dem Looker-Tableau-Connector können Sie Tableau Desktop verwenden, um eine Verbindung zu Daten aus einem Looker-Explore herzustellen. Der Looker-Tableau-Connector basiert auf der offenen SQL-Schnittstelle von Looker, die den Zugriff auf LookML-Modelle und Explores für Anwendungen ermöglicht, die JDBC für die Verbindung zu Datenquellen verwenden. Weitere Informationen finden Sie in der Dokumentation zur Open SQL-Schnittstelle.

Diese Anleitung bezieht sich auf die öffentliche Vorschau des Looker-Tableau-Connectors. Wenn Sie Fragen stellen oder Feedback geben möchten, senden Sie eine E-Mail an tableau-looker@google.com.

Voraussetzungen

Die folgenden Komponenten sind erforderlich, um den Looker-Tableau-Connector zu verwenden:

Außerdem müssen Sie die folgenden Schritte ausführen, bevor Sie den Looker-Tableau-Connector einrichten:

Tableau Desktop für die Verbindung mit Looker einrichten

So verwenden Sie den Looker-Tableau-Connector in der öffentlichen Vorschau:

  1. Die Tableau OAuth-App zu Ihrer Looker-Instanz hinzufügen: Ein Looker-Administrator muss die Looker API verwenden, um die Tableau OAuth-App für den Looker-Tableau-Connector auf Ihrer Looker-Instanz zu registrieren. Die OAuth-Anwendung von Tableau muss nur einmal für jede Looker-Instanz registriert werden und gilt für alle Benutzer der Looker-Instanz.
  2. Tableau-Connector-Datei und JDBC-Treiberdatei herunterladen und speichern: Jeder Nutzer, der auf den Looker-Tableau-Connector zugreifen möchte, muss die avatica-<release_number>-looker.jar-Datei und die gepackte Tableau-Connector-Datei (.taco) herunterladen und die Dateien dann in bestimmten Verzeichnissen auf dem Computer speichern.

In den folgenden Abschnitten werden diese Schritte ausführlich beschrieben.

OAuth-Anwendung von Tableau zu Ihrer Looker-Instanz hinzufügen

Für den Looker-Tableau-Connector muss die Tableau OAuth-Anwendung auf Ihrer Looker-Instanz installiert sein. Am einfachsten können Sie die Tableau OAuth-App auf Ihrer Looker-Instanz über den Looker API Explorer registrieren.

Wenn auf Ihrer Looker-Instanz der API Explorer bereits installiert ist, können Sie mit diesem URL-Format darauf zugreifen:

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

Wenn der API Explorer in Ihrer Looker-Instanz nicht verfügbar ist, können Sie ihn über den Looker Marketplace installieren. Informationen hierzu finden Sie auf der Seite API Explorer verwenden.

Verwenden Sie den API Explorer, um die Tableau OAuth-Anwendung auf Ihrer Looker-Instanz zu registrieren, wie in den folgenden Schritten beschrieben:

  1. Öffnen Sie den Looker API Explorer (weitere Informationen auf der Seite API Explorer verwenden).
  2. Geben Sie in das Feld Suche des API Explorers Register OAuth App (OAuth-App registrieren) ein.
  3. Klicken Sie in den Suchergebnissen auf Register OAuth Application (OAuth-App registrieren).
  4. Klicken Sie auf der Seite Register OAuth App (OAuth-App registrieren) auf Run It (Ausführen).
  5. Geben Sie im Dialogfeld Ausführen auf dem Tab Anfrage die folgenden Informationen in die entsprechenden Felder ein:

    • 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. Klicken Sie auf das Kästchen Ich habe verstanden, dass dieser API-Endpunkt Daten ändern wird.

  7. Klicken Sie auf Ausführen.

  8. Mit der Methode Get OAuth Client App im API Explorer können Sie prüfen, ob Sie die Tableau OAuth-App erfolgreich registriert haben:

    • Geben Sie in das Feld Suchen des API Explorers Get OAuth Client App ein.
    • Klicken Sie auf Run It (Ausführen).
    • Geben Sie im Feld client_guid den Wert der Tableau OAuth-Anwendung ein:

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

    Wenn Sie die Tableau OAuth-App erfolgreich registriert haben, werden auf dem Tab Response (Antwort) die Werte angezeigt, die Sie bei der Registrierung der App eingegeben haben.

Dieser Schritt ist nicht erforderlich. Wenn Sie den Looker-Tableau-Connector jedoch in Zukunft nicht mehr verwenden und die Tableau-OAuth-App entfernen möchten, lesen Sie die Informationen unter OAuth-App entfernen.

Connector-Dateien herunterladen und speichern

Um den Looker-Tableau-Connector zu verwenden, muss jeder Tableau-Benutzer diese beiden Dateien herunterladen:

In den folgenden Abschnitten finden Sie eine Anleitung zum Herunterladen dieser Dateien und wo Sie sie auf Ihrem Computer ablegen.

Datei des Tableau-Connectors (.taco)

Die Tableau-Connector-Datei heißt looker-jdbc-v0.2.0.taco. Jeder Nutzer muss die Datei .taco herunterladen und auf seinem Computer speichern. Das geht so:

  1. Klicken Sie auf den folgenden Link, um die Tableau-Connector-Datei herunterzuladen: looker-jdbc-v0.2.0.taco.
  2. Wenn der Download abgeschlossen ist, verschieben Sie die Datei looker-jdbc-v0.2.0.taco in das Unterverzeichnis Connectors des Verzeichnisses My Tableau Repository. Dies sind die Standardverzeichnispfade:

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

JDBC-Treiberdatei (looker.jar)

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

  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 den Computern aller Nutzer unter dem folgenden Pfad:

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

Verbindung zu Looker-Daten von Tableau Desktop herstellen

Nachdem Sie die Tableau OAuth-App zu Ihrer Looker-Instanz hinzugefügt und die Dateien looker-jdbc-v0.2.0.taco und avatica-<release_number>-looker.jar heruntergeladen haben, können Sie Tableau Desktop verwenden, um eine Verbindung zu Daten aus Ihrer Looker-Instanz herzustellen. 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 in das Suchfeld Looker JDBC by Google ein.
  3. Wählen Sie die Option Looker JDBC 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 dem 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. Geben Sie Ihre OAuth-Anmeldedaten ein, wenn Sie dazu aufgefordert werden. Wenn Sie bereits angemeldet sind, wird im Browserfenster eine Meldung angezeigt, dass Tableau das Browserfenster zur Authentifizierung bei Looker verwendet hat und dass Sie das Browserfenster jetzt schließen können.
  7. Nach der Authentifizierung bei Looker öffnet Tableau eine Datenquelle-Seite mit einer Verbindung zu Ihrer Looker-Instanz.
  8. Verwenden Sie das Drop-down-Menü Schema, um ein Looker-model mit den Daten auszuwählen, die Sie in Tableau Desktop anzeigen möchten. Tableau füllt die Liste Table (Tabelle) mit den Looker-Explores aus dem von Ihnen ausgewählten Looker-Modell.
  9. Wählen Sie zuerst ein Objekt aus der Liste Tables (Tabellen) aus und ziehen Sie es auf den Canvas.

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

Abfragen von Tableau werden über die Open SQL-Schnittstelle durchgeführt. Looker-Administratoren können über die Looker-Benutzeroberfläche herausfinden, welche Abfragen von der Open SQL-Benutzeroberfläche stammen, wie in der Dokumentation zur Open SQL-Schnittstelle beschrieben.

Abfragen vom Looker-Tableau-Connector haben für Source den Wert „sql_interface“ oder „Sql Interface“.

Wichtige Punkte

Beachten Sie beim Untersuchen von Looker-Daten mit Tableau Desktop die folgenden Überlegungen:

  • Der Looker-Tableau-Connector basiert auf der offenen SQL-Oberfläche von Looker und hat dieselben LookML-Einschränkungen wie die Open SQL-Schnittstelle. Weitere Informationen finden Sie in der Dokumentation zur Open SQL-Schnittstelle.
  • Tableau fragt automatisch die Datenbank ab, wenn eine Änderung an der Abfrage vorgenommen wird, auch wenn Felder mithilfe des Looker-Tableau-Connectors hinzugefügt und entfernt werden. Sie können automatische Updates in Tableau deaktivieren: Weitere Informationen finden Sie in der Tableau-Dokumentation.
  • Sie können Tableau nicht verwenden, um zwei Looker-Explores zu verknüpfen. Wenn Sie Explores zusammenführen möchten, verwenden Sie Looker, um die Joins in Ihrem Looker-Modell zu erstellen. Informationen zur Verwendung von Joins in Looker finden Sie auf den Looker-Dokumentationsseiten Mit Joins in LookML arbeiten und Join-Parametern.

Fehler melden

Wenn Sie einen Fehler melden möchten, senden Sie eine E-Mail mit den folgenden Informationen an tableau-looker@google.com:

  • Eine detaillierte Liste Ihrer Schritte
  • Das erwartete Verhalten
  • Das tatsächliche Verhalten (wenn möglich mit einem Screenshot)

Tableau OAuth-Anwendung entfernen (optional)

Dieser Schritt ist nicht erforderlich. Wenn Sie den Looker-Tableau-Connector in Zukunft jedoch nicht mehr verwenden und die Tableau OAuth-App aus Ihrer Looker-Instanz entfernen möchten, können Sie dies mit dem API Explorer tun. Gehen Sie dazu so vor:

  1. Öffnen Sie den Looker API Explorer (weitere Informationen auf der Seite API Explorer verwenden).
  2. Geben Sie in das Feld Suchen des API Explorers OAuth-Client-App löschen ein.
  3. Klicken Sie in den Suchergebnissen auf OAuth-Clientanwendung löschen.
  4. Klicken Sie auf der Seite OAuth-Clientanwendung löschen auf die Schaltfläche Ausführen.
  5. Geben Sie im Dialogfeld Ausführen auf dem Tab Anfrage den Wert für client_guid der Tableau-OAuth-Anwendung ein:

    35FBB268-0CB0-4822-AFE3-28638C1C6269
    
  6. Klicken Sie auf das Kästchen Ich habe verstanden, dass dieser API-Endpunkt Daten ändern wird.

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

    • Geben Sie in das Feld Suchen des API Explorers Get OAuth Client App ein.
    • Klicken Sie auf Run It (Ausführen).
    • Geben Sie im Feld client_guid den Wert der Tableau OAuth-Anwendung ein:

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

    Wenn Sie die Tableau-OAuth-App erfolgreich entfernt haben, gibt der Tab Response leere Textkörperwerte zurück.