Quick Link für verbundene Tabellenblätter

Vorabversion: Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind „im Ist-Zustand“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Wenn Sie während der öffentlichen Vorabversion der Option Aktionen für Explore im Zahnradmenü von verbundenen Tabellenblättern ein Problem feststellen, melden Sie es unter [e-mail].

Auf dieser Seite wird beschrieben, wie Sie die Option Verbundene Tabellenblätter im Zahnradmenü Aktionen für Explore in Looker aktivieren und verwenden. Mit der Option Verbundene Tabellenblätter wird Google Sheets geöffnet und eine Verbindung von Google Sheets zum Looker-Explore hergestellt. Anschließend können Sie in der neu erstellten Google-Tabelle Berichte, Pivot-Tabellen oder Diagramme mit den Feldern aus dem ausgewählten Looker-Explore erstellen.

Hinweis

Für die Verwendung des Quick Links Verbundene Tabellenblätter benötigen Sie Folgendes:

• Eine Looker-Instanz, die von einem Administrator für die Funktion aktiviert und konfiguriert wurde, wie im Abschnitt Quick Link für verbundene Tabellenblätter aktivieren und konfigurieren auf dieser Seite beschrieben
• Ein Looker-Nutzerkonto mit der explore Berechtigung für die LookML-Modelle, die Sie mit Google Sheets verbinden möchten
• Ein Google-Konto mit derselben E-Mail-Adresse, die mit Ihrem Looker-Konto verknüpft ist

Hinweis: Diese Funktion ist für Looker-Einbettungsnutzer nicht verfügbar.

Quick Link für verbundene Tabellenblätter aus einem Explore verwenden

Wenn Ihr Looker-Administrator die Funktion aktiviert hat, können Sie eine Verbindung zwischen Google Sheets und jedem Explore herstellen, auf das Sie Zugriff haben:

1. Melden Sie sich in Looker mit der E-Mail-Adresse an, die mit Ihrem Google-Konto verknüpft ist.

2. Rufen Sie in Looker das Explore auf, das Sie als Datenquelle verwenden möchten.

   **Tipp**: Sie müssen keine Abfrage im Explore erstellen. Sie können das Explore leer lassen.

3. Klicken Sie auf das Zahnradsymbol Aktionen für Explore und wählen Sie Verbundene Tabellenblätter aus.

4. Wenn Sie diese Funktion zum ersten Mal verwenden, werden Sie aufgefordert, Looker den Zugriff auf Ihr Google-Konto zu gewähren. Wählen Sie das Google-Konto aus, das Sie verwenden möchten. Die E-Mail-Adresse für das Google-Konto muss mit der E-Mail-Adresse übereinstimmen, die mit Ihrem Looker-Nutzerkonto verknüpft ist.

5. Überprüfen Sie die Berechtigungen, die auf dem Zustimmungsbildschirm angefordert werden, und klicken Sie auf Zulassen.

6. Ein neuer Browsertab wird in Google Sheets geöffnet und ein Dialogfeld wird angezeigt, in dem Sie gefragt werden, ob Sie Ihr Google-Konto mit Ihrem Looker-Konto verknüpfen möchten. Klicken Sie auf Konto verknüpfen.

Die Google-Tabelle ist jetzt mit dem Looker-Explore verbunden, von dem aus Sie gestartet sind. In der Google-Tabelle können Sie Felder aus dem Explore hinzufügen, Pivot-Tabellen erstellen, Diagramme erstellen und Formeln anwenden, um die Daten aus Ihrem Looker-Explore zu analysieren.

Weitere Informationen zum Erstellen von Abfragen in verbundenen Tabellenblättern finden Sie auf der Dokumentationsseite Verbundene Tabellenblätter für Looker verwenden.

Quick Link für verbundene Tabellenblätter aktivieren und konfigurieren

Damit der Quick Link Verbundene Tabellenblätter im Zahnradmenü Aktionen für Explore aktiviert werden kann, muss Ihre Looker-Instanz die folgenden Anforderungen erfüllen:

• Auf Ihrer Instanz muss Looker 25.20 oder höher ausgeführt werden.
• Bei Looker (Google Cloud Core)-Instanzen wird der Quick Link Verbundene Tabellenblätter nur für öffentliche sichere Verbindungen oder hybride Verbindungen unterstützt. Looker (Google Cloud Core)-Instanzen mit privaten Verbindungen (privater Dienstzugriff) werden nicht unterstützt.
• Bei Looker-Instanzen (Original) wird der Quick Link Verbundene Tabellenblätter nur für von Looker gehostete Instanzen unterstützt. Von Kunden gehostete Looker-Instanzen werden nicht unterstützt.

Damit die Option Verbundene Tabellenblätter im Zahnradmenü Aktionen für Explore in einer Looker-Instanz aktiviert werden kann, muss ein Administrator die folgenden allgemeinen Aufgaben ausführen, die in den folgenden Abschnitten beschrieben werden:

• Aktivieren Sie die Google Sheets API in der Google Cloud Console.
• Erstellen Sie in der Google Cloud Console einen OAuth-Client im selben Google Cloud Console-Projekt, in dem die Google Sheets API aktiviert wurde.
• Aktivieren und konfigurieren Sie die Option Quick Link für verbundene Tabellenblätter aktivieren auf der Seite „BI-Connectors“ von Looker.

Google Sheets API in der Google Cloud Console aktivieren

Der Quick Link Verbundene Tabellenblätter verwendet die Google Sheets API. Diese API muss daher in demselben Projekt aktiviert sein, das Sie zum Erstellen des OAuth-Clients verwenden. Die Google Sheets API kann von einem IAM-Nutzer mit der IAM roles/serviceusage.serviceUsageAdmin Berechtigung aktiviert werden.

Führen Sie die folgenden Schritte aus, um die Google Sheets API zu aktivieren:

1. Gehen Sie im Google Cloud Navigationsmenü derConsole zu APIs und Dienste > Bibliothek und öffnen Sie die Google Sheets API.

   Zur Google Sheets API

2. Wählen Sie in der Google Cloud Console Projektauswahl öffnen das Projekt aus, das Sie verwenden möchten, um eine Verbindung zu Google Sheets aus Ihren Looker-Explores herzustellen. Sie müssen während der gesamten Einrichtung des Quick Links für verbundene Tabellenblätter dasselbe Google Cloud Console-Projekt verwenden, damit die Google Sheets API in demselben Projekt aktiviert wird, in dem Sie OAuth konfigurieren.

3. Klicken Sie auf der Seite „Google Sheets API“ auf Aktivieren, wenn die API noch nicht aktiviert ist.

OAuth-Client erstellen

Ein IAM-Nutzer mit den erforderlichen Rollen muss einen OAuth-Client erstellen.

Sie können den OAuth-Client in einem beliebigen Google Cloud Projekt einrichten. Die Google Sheets API muss jedoch in diesem Projekt aktiviert sein.

Hinweis: Bevor Sie Ihre OAuth-Anmeldedaten generieren können, müssen Sie einen OAuth-Zustimmungsbildschirm konfigurieren. Dort können Nutzer festlegen, wie sie Zugriff auf ihre privaten Daten erteilen. Wenn Sie noch keinen OAuth-Zustimmungsbildschirm für Ihr ausgewähltes Google Cloud Console-Projekt konfiguriert haben, wird in der Google Cloud Console eine Benachrichtigung mit der Schaltfläche Zustimmungsbildschirm konfigurieren angezeigt. Klicken Sie auf die Schaltfläche und folgen Sie der Anleitung auf der Dokumentationsseite OAuth-Zustimmungsbildschirm konfigurieren und Bereiche auswählen. Kehren Sie dann zu dieser Anleitung zurück.

So erstellen Sie den Client und seine Anmeldedaten:

1. Öffnen Sie in der Google Cloud Console mit der Google Cloud Console Projektauswahl öffnen dasselbe Projekt, in dem Sie die Google Sheets API aktiviert haben.

   Zur Console Google Cloud

2. Rufen Sie im Hauptmenü der Google Cloud Console APIs und Dienste > Anmeldedaten auf.

3. Klicken Sie auf der Seite Anmeldedaten auf das Drop-down-Menü Anmeldedaten erstellen und wählen Sie dann OAuth-Client-ID aus.

4. Wählen Sie im Drop-down-Menü Anwendungstyp die Option Webanwendung aus.

5. Geben Sie im Feld Name einen Namen für Ihren OAuth-Client ein, z. B. Looker to Connected Sheets.

6. Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf die Schaltfläche URI hinzufügen. Fügen Sie den folgenden URI hinzu:

   https://LOOKER_INSTANCE_URL/oauth2callback
   

7. Klicken Sie auf die Schaltfläche URI hinzufügen , um auch den folgenden URI hinzuzufügen:

   https://LOOKER_INSTANCE_URL/external_oauth/redirect
   

8. Klicken Sie auf Erstellen.

9. Nachdem Sie auf Erstellen geklickt haben, wird das Fenster OAuth-Client erstellt angezeigt. In diesem Fenster werden die Client-ID und der Clientschlüssel angezeigt, die von der Google Cloud Console für Ihren OAuth-Client erstellt wurden. Kopieren Sie diese Werte und notieren Sie sie sich, da sie bei der Konfiguration der Option „Quick Link für verbundene Tabellenblätter aktivieren“ erforderlich sind.

Option „Quick Link für verbundene Tabellenblätter aktivieren“ konfigurieren

Nachdem Sie die Google Sheets API in der Google Cloud Console aktiviertund den OAuth-Client in der Google Cloud Console erstellthaben, können Sie den Quick Link Verbundene Tabellenblätter in Ihrer Looker-Instanz aktivieren. Führen Sie dazu die folgenden Schritte aus:

1. Wählen Sie in Ihrer Looker-Instanz im Bereich Plattform des Bereichs Verwaltung die Option BI-Connectors aus.
2. Aktivieren Sie die Option Google Sheets , falls sie noch nicht aktiviert ist.
3. Aktivieren Sie die verschachtelte Option Quick Link für verbundene Tabellenblätter aktivieren.
4. Fügen Sie in die Felder Client-ID und Clientschlüssel die Werte ein, die Sie beim Erstellen des OAuth-Clients in der Google Cloud Console aus derConsole kopiert haben. Google Cloud
5. Klicken Sie auf Speichern.

Die Option Verbundene Tabellenblätter im Zahnradmenü Aktionen für Explore ist jetzt für Ihre Looker-Instanz eingerichtet.

Vom Pilotprogramm migrieren

Wenn Ihre Organisation am früheren Pilotprogramm für die Funktion In Google Sheets öffnen teilgenommen hat, wurde in Ihrer Looker-Instanz ein zentral verwalteter OAuth-Client verwendet, der von Looker bereitgestellt wurde. Diese Einrichtung wird zugunsten einer sichereren und skalierbareren Methode eingestellt, bei der jeder Looker-Administrator seinen eigenen OAuth-Client für seine Looker-Instanz konfiguriert. Bestehende Pilotkunden sollten zu dieser neuen Konfiguration wechseln, um die Funktionalität beizubehalten.

Für die Migration zur neuen Version muss ein Administrator den OAuth-Client Ihrer Organisation in der Google Cloud Console einrichten und dann die Anmeldedaten auf der Looker-Administrationsseite „BI-Connectors“ konfigurieren. Die Schritte sind dieselben wie bei der ersten Einrichtung, die in den folgenden Abschnitten auf dieser Seite beschrieben wird:

• Google Sheets API in der Google Cloud Console aktivieren
• OAuth-Client in der Google Cloud Console im selben Google Cloud Console-Projekt erstellen, in dem die Google Sheets API aktiviert wurde
• Option „Quick Link für verbundene Tabellenblätter aktivieren“ auf der Seite „BI-Connectors“ von Looker aktivieren und konfigurieren

Nachdem ein Administrator diese Schritte ausgeführt hat, verwendet Ihre Instanz automatisch den neuen vom Kunden verwalteten OAuth-Ablauf. Die vorherige Pilotfunktion und ihre Abhängigkeit vom von Looker verwalteten OAuth-Client sind nicht mehr aktiv.

Fehlerbehebung

• Fehler wegen nicht übereinstimmender E-Mail-Adressen:Wenn beim Google-Authentifizierungsschritt ein Fehler auftritt, prüfen Sie, ob das ausgewählte Google-Konto genau dieselbe E-Mail-Adresse wie Ihr Looker-Nutzerkonto hat.
• Option „Verbundene Tabellenblätter“ nicht sichtbar:Diese Option wird nur im Zahnradmenü Aktionen für Explore angezeigt, wenn Ihr Looker-Administrator die Funktion in den BI-Connector-Einstellungen aktiviert hat. Wenden Sie sich an Ihren Looker-Administrator.
• Google Cloud Console-Berechtigungen: Der Administrator, der den OAuth-Client und den Zustimmungsbildschirm konfiguriert, muss die roles/oauthconfig.editor und roles/serviceusage.serviceUsageAdmin Berechtigungen im Google Cloud Projekt haben.
• Bei anderen Problemen oder Feedback während der öffentlichen Vorabversion senden Sie eine E-Mail an [e-mail].