Verbundene Tabellenblätter für Looker verwenden

Mit verbundenen Tabellenblättern für Looker können Nutzer Daten aus LookML-Modellen interaktiv über die vertraute Google Sheets-Tabellenoberfläche untersuchen. Google Sheets-Nutzer haben Zugriff auf verwaltete Daten aus mehr als 50 von Looker unterstützten Datenbanken. Die Untersuchung ist intuitiv, da verbundene Tabellenblätter eine organisierte Ansicht des Modells mit Ansichten, Feldern und Messwerten bieten, so wie sie in Looker definiert wurden. Looker-Daten, die über verbundene Tabellenblätter abgerufen werden, können in Standardkonstrukten von Google Sheets wie Pivot-Tabellen, Diagrammen und Formeln verwendet werden. Das ermöglicht eine flexible Analyse mit vertrauten Konstrukten.

Verbundene Tabellenblätter aktivieren

Damit Sie verbundene Tabellenblätter verwenden können, muss Ihre Instanz die folgenden Anforderungen erfüllen:

  • In Looker (Original) muss Ihr Looker-Administrator den vorkonfigurierten Connected Sheets-Client auf dem Tab Anwendungsbibliothek auf der Seite OAuth-Clients verwalten (Admin > Authentifizierung > OAuth-Clients verwalten) aktivieren oder entweder den Schalter Alle Looker-BI-Connectors oder Google Sheets im Bereich „BI-Connectors“ im Abschnitt Plattform des Admin-Menüs von Looker aktivieren. In Looker (Google Cloud Core) sind diese Optionen standardmäßig aktiviert.
  • Ihre Looker (Original)-Instanz muss von Looker gehostet werden.
  • Wenn für Ihre Looker-Instanz (Original) eine IP-Zulassungsliste konfiguriert ist, müssen Sie die IP-Zulassungsliste deaktivieren, um verbundene Tabellenblätter verwenden zu können. Es gibt keine spezifische oder kuratierte statische Liste von Google Sheets-IP-Adressen, die der Zulassungsliste hinzugefügt werden können.
  • In Looker (Google Cloud Core) sind verbundene Tabellenblätter standardmäßig aktiviert. Wenn Sie jedoch eine Looker (Google Cloud Core)-Instanz verwenden, für die eine IP-Zulassungsliste konfiguriert ist, muss das Kästchen Google-Dienste mit dieser Instanz verknüpfen auf dem Tab Details der Seite Instanz der Instanz in der Google Cloud Console ausgewählt sein, um eine Verbindung zu verbundenen Tabellenblättern herzustellen.
  • Alle Nutzer, die über Google Sheets eine Verbindung zu Ihrer Looker-Instanz herstellen möchten, müssen in ihrem Looker-Nutzerkonto dieselbe E‑Mail-Adresse verwenden wie in ihrem Google Workspace-Konto. Wenn die E‑Mail-Adressen des Google Workspace- und des Looker-Kontos nicht übereinstimmen, erhalten sie eine Fehlermeldung, wenn sie versuchen, von Google Sheets aus eine Verbindung zu Looker herzustellen.
  • Der Zugriff auf Dienste, die nicht einzeln gesteuert werden, muss in der Google Workspace-Admin-Konsole aktiviert sein. Diese ist in der Regel standardmäßig aktiviert. Weitere Informationen finden Sie im Hilfeartikel Dienste ohne eigene Einstellung verwalten.

Verbindung mit einem Look aus Google Sheets herstellen

In Looker ist ein Look eine einzelne Abfrage, die zuvor gespeichert wurde. Sie können die Ergebnisse eines Looks in eine Tabelle einfügen und dann in Google Sheets mit der Ausgabe des Looks interagieren.

  1. Wählen Sie in Google Sheets im Menü Daten die Option Daten-Connectors und dann Mit Looker verbinden aus.

  2. Geben Sie im Dialogfeld Mit Looker verbinden den Namen Ihrer Looker-Instanz ein oder wählen Sie den Namen einer Instanz aus, mit der Sie vor Kurzem verbunden waren, und wählen Sie Mit Look verbinden aus.

  3. Wählen Sie im folgenden Dialogfeld den Look aus, den Sie Google Sheets hinzufügen möchten, und wählen Sie dann Verbinden aus. Sie können das Feld Nach einem Look suchen verwenden, um nach einem gespeicherten Look anhand des Namens oder der Look-ID zu suchen. Alternativ können Sie die Liste der im Dialogfeld angezeigten Looks filtern, indem Sie einen Teilstring eingeben, der im Look-Namen enthalten ist.

  4. Wählen Sie im Dialogfeld Mit einem Look verbinden aus, ob Sie ein neues Tabellenblatt für die Look-Ausgabe erstellen oder die Look-Ausgabe einem vorhandenen Tabellenblatt hinzufügen möchten, und wählen Sie Erstellen aus.

Wenn Google Sheets eine Verbindung zu Ihrer Looker-Instanz herstellt, wird die Ausgabe des ausgewählten Looks hinzugefügt.

Looks können in Google Sheets nicht bearbeitet werden. Sie können die Look-Daten jedoch jederzeit aktualisieren, indem Sie auf Aktualisieren klicken. Sie können auf die Look-URL klicken, um den Look in Looker zu öffnen. Sie können den Namen, die ID und die URL des Looks auch in der Look-Seitenleiste sehen.

Verbindung zu einem Looker-Explore über Google Sheets herstellen

Ein Explore ist der Ausgangspunkt für Abfragen. In einem Explore wird eine bestimmte Gruppe von Feldern aus der zugehörigen Ansichtsdatei angezeigt. Diese Felder können ausgewählt werden, um eine Abfrage in einer Tabelle zu erstellen.

  1. Wählen Sie in Google Sheets im Menü Daten die Option Daten-Connectors und dann Mit Looker verbinden aus.

  2. Geben Sie im Dialogfeld Mit Looker verbinden den Namen Ihrer Looker-Instanz ein oder wählen Sie den Namen einer Instanz aus, mit der Sie vor Kurzem eine Verbindung hergestellt haben, und wählen Sie Mit Explore verbinden aus.

  3. Wählen Sie in den folgenden Dialogfeldern das Looker-Modell und das Explore aus, das Sie für Ihre Abfrage verwenden möchten, und wählen Sie Verbinden aus.

Wenn Google Sheets eine Verbindung zu Ihrer Looker-Instanz herstellt, wird ein neues Tabellenblatt geöffnet, das die Struktur des ausgewählten Explores zeigt, einschließlich Ansichten, Dimensionen, Messwerten und allen Feldbeschreibungen, die von Ihrem Looker-Entwickler hinzugefügt wurden.

Looker-Abfragen mit Google Sheets erstellen

Looker-Abfragen werden mit einer Pivot-Tabelle in Google Sheets erstellt. So fügen Sie Ihrer Tabelle Looker-Daten hinzu:

  1. Wählen Sie im Tabellenblatt, in dem Ihr Explore angezeigt wird, die Option Pivot-Tabelle aus.

  2. Wählen Sie aus, ob Sie eine neue Pivot-Tabelle in ein neues oder ein vorhandenes Tabellenblatt einfügen möchten, und klicken Sie auf Erstellen.

    Eine neue, leere Pivot-Tabelle wird erstellt und das Fenster Editor für Pivot-Tabellen wird geöffnet. Sie können Zeilen, Spalten, Werte und Filter hinzufügen, um Ihre Abfrage basierend auf den Dimensionen und Messwerten in Ihrem Looker-Explore zu erstellen.

    Die Zeilen, Spalten, Werte und Filter im Pivot-Editor entsprechen den Looker-Dimensionen und ‑Messwerten folgendermaßen:

    • Zeilen entsprechen Dimensionen in Looker.
    • Spalten entsprechen Pivot-Dimensionen in Looker.
    • Werte entsprechen den Messwerten in Looker. Sie können eine benutzerdefinierte Messung erstellen, indem Sie eine Looker-Dimension und eine Sheets-Funktion Zusammenfassen nach auswählen.
    • Filter entsprechen den Looker-Filtern.

    Im Pivot-Editor wird auch eine Liste der Ansichten angezeigt, die Teil Ihres Explores sind. Sie können sie auswählen, um die Dimensionen und Messwerte anzuzeigen, die in dieser Ansicht enthalten sind.

  3. Wählen Sie Hinzufügen aus, um eine Zeile, eine Spalte, einen Wert oder einen Filter hinzuzufügen. In verbundenen Tabellenblättern wird eine Liste der Ansichten angezeigt, die in Ihrem Explore verfügbar sind. Wählen Sie einen Ansichtsnamen aus, um die Liste der Dimensionen und Messwerte in der Ansicht aufzurufen. Wählen Sie dann das Feld aus, das die Daten für Ihre Zeile, Spalte, Ihren Wert oder Filter liefert.

  4. Nachdem Sie die Looker-Felder und ‑Filter für Ihre Abfrage hinzugefügt haben, wählen Sie Anwenden aus. Dadurch wird Ihre Tabelle mit Daten aus Ihrer Looker-Instanz gefüllt.

Nachdem Sie Ihre Looker-Daten einer Pivot-Tabelle hinzugefügt haben, können Sie sie in Google Sheets formatieren oder neue Google Sheets-Formeln basierend auf Ihren Looker-Daten erstellen.

Filteroptionen

Seit der ersten Veröffentlichung von verbundenen Tabellenblättern für Looker wurden neue Filteroptionen hinzugefügt.

Nach Wert filtern

In verbundenen Tabellenblättern für Looker-Pivot-Tabellen können Sie Looker-Dimensionen filtern, indem Sie sich eine Liste mit Werten ansehen und die gewünschten Werte auswählen oder die Auswahl aufheben. Bisher mussten Sie die Filterwerte manuell eingeben, wenn Sie nach einer Bedingung gefiltert haben.

Wenn Sie diese Funktion verwenden möchten, fügen Sie dem Bereich Filter der Pivot-Tabelle ein Feld hinzu und klicken Sie auf das Drop-down-Menü Status, um die Filteroptionen zu öffnen. Klicken Sie dann auf Filter hinzufügen:

Daraufhin wird eine Seitenleiste geöffnet und in Google Sheets werden die 500 am häufigsten vorkommenden Werte aus Looker abgerufen.

Du kannst dann nach den Elementen suchen, alle auswählen oder die Auswahl aufheben oder die Elemente nach Häufigkeit oder alphabetisch sortieren. Wenn Sie unten auf OK klicken, werden Ihre Einstellungen in Google Sheets gespeichert. Klicken Sie dann auf Anwenden, um die Pivot-Tabelle wie gewohnt mit dem neuen Filter zu aktualisieren.

Filter mit Looker-Filterausdrücken

In verbundenen Tabellenblättern können Sie relative Datumsfilter sowie viele andere erweiterte Filter mithilfe von Looker-Filterausdrücken anwenden. In verbundenen Tabellenblättern können Sie beispielsweise Filter wie „liegt in den letzten 30 Minuten“ oder „liegt in den letzten 10 Tagen“ anwenden.

So verwenden Sie Looker-Filterausdrücke:

  1. Fügen Sie dem Filterbereich der Pivot-Tabelle ein Feld hinzu.

  2. Klicken Sie auf das Drop-down-Menü Status, um die Filteroptionen aufzurufen, und wählen Sie Filterausdruck aus.

  3. Geben Sie einen beliebigen Looker-Filterausdruck in das Feld Wert ein.

    Wenn Sie beispielsweise nach den letzten 7 Tagen filtern möchten, können Sie entweder „7 Tage“ oder „letzte 7 Tage“ eingeben.

  4. Klicken Sie auf OK.

Neben der relativen Datumsfilterung sind jetzt auch andere Filter möglich, z. B.:

  • Ein String, der nicht mit -FOO% beginnt
  • Ein einschließender und ausschließender numerischer Bereich: (12, 20]

Eine Liste aller verfügbaren Filterausdrücke finden Sie auf der Dokumentationsseite Looker-Filterausdrücke.

Looker-Parameter und Nur-Filter-Felder verwenden

Sie können jetzt Parameter und Nur-Filter-Felder in verbundenen Tabellenblättern verwenden.

Nur-Filter-Felder und Parameter werden im Bereich NUR-FILTER-FELDER der Feldauswahl in Google Sheets angezeigt, ähnlich wie in Looker. So verwenden Sie sie:

  1. Fügen Sie die ausgewählten Parameter und Nur-Filter-Felder dem Bereich Filter hinzu oder ziehen Sie sie dorthin, genau wie Sie es tun würden, um nach einer Dimension oder einem Messwert zu filtern.
  2. Bei Parametern mit zulässigen Werten werden diese Werte im Dialogfeld Nach Bedingung filtern in einem Drop-down-Menü angezeigt.
  3. Für reine Filterfelder können Sie das reguläre Dialogfeld Nach Bedingung filtern verwenden. Wenn für das Feld im Looker-Modell Vorschläge definiert sind, können Sie auch die Funktion Nach Wert filtern verwenden.

Daten in Google Sheets aktualisieren

Die Daten in Ihrer Pivot-Tabelle sind statisch, können aber jederzeit aktualisiert werden. Wenn Sie Ihre Daten aktualisieren, fragt Looker Ihre Datenbank ab und aktualisiert Ihre Pivot-Tabelle mit den neuesten Daten.

Sowohl in der Pivot-Tabelle als auch im Tabellenblatt mit dem Look oder Explore wird die Uhrzeit der letzten Aktualisierung angezeigt.

Wählen Sie Aktualisieren aus, um die Daten in der Pivot-Tabelle zu aktualisieren.

Regelmäßige Aktualisierungszeiten planen

Wenn Sie automatische Aktualisierungen Ihrer Daten planen möchten, wählen Sie entweder das Dreipunkt-Menü in Ihrer Pivot-Tabelle und dann Aktualisierungsoptionen aus oder wählen Sie Aktualisierungsoptionen in Ihrem Explore-Blatt aus. Looker zeigt das Dialogfeld Geplante Aktualisierung an.

Einstellungen für Pivot-Tabellen bearbeiten

Wenn Sie ändern möchten, welche Zeilen, Spalten, Werte oder Filter in der Pivot-Tabelle enthalten sind, wählen Sie das Stiftsymbol neben dem Dreipunkt-Menü aus, um das Bearbeitungsfeld für Pivot-Tabellen zu öffnen.

Verbundene Tabellenblätter überwachen

Ein Looker-Administrator kann die Nutzung von verbundenen Tabellenblättern im Explore „Systemaktivitätsverlauf“ über die Feldgruppe Query API Client Properties einsehen. Jedes Mal, wenn eine neue Abfrage ausgeführt wird, wird ein Eintrag im Explore Verlauf erstellt.

In der Feldgruppe Query API Client Properties gibt es drei neue Felder für verbundene Tabellenblätter:

  • API Client Name: In diesem Feld wird immer Connected Sheets angezeigt, um verbundene Tabellenblätter zu identifizieren.
  • ID für verbundene Tabellenblätter: In diesem Feld wird die Tabellen-ID angezeigt, die in der Google Sheets-URL für dieses Tabellenblatt enthalten ist.
  • Connected Sheets Trigger: In diesem Feld wird angezeigt, ob die Abfrage durch einen Nutzer ausgelöst wurde, der in Google Sheets die Schaltfläche Aktualisieren ausgewählt hat, oder durch eine geplante Aktualisierung.

Im Folgenden finden Sie ein Beispiel für eine Systemaktivitäts-URL, die die Nutzung von verbundenen Tabellenblättern zeigt. Ersetzen Sie <instance_name.looker.com> durch die URL Ihrer Instanz.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

Unterstützung für die Connected Sheets API

Die API-Unterstützung für verbundene Tabellenblätter für Looker ist sowohl über AppsScript als auch über die Google Sheets API verfügbar.

Mit der API können Sie unter anderem Folgendes programmatisch tun:

  • Automatische Datenaktualisierung: Sie können regelmäßige Aktualisierungen für Ihre Looker-basierten Tabellen planen, damit Sie immer die neuesten Informationen verwenden.
  • Benutzerdefinierte Workflows: Sie können komplexe Prozesse erstellen, bei denen Looker-Daten in Ihre vorhandenen Google Sheets-Workflows eingebunden werden.
  • Integration in andere Anwendungen: Sie können Looker-Daten über AppsScript oder Google Sheets APIs mit externen Tools und Diensten verbinden.

Wenn Sie Looker mit der Google Sheets API als Datenquelle angeben möchten, verwenden Sie das Objekt looker mit der REST-Ressource DataSourceSpec.

Wichtige Punkte

  • Die Berücksichtigung der Groß-/Kleinschreibung für die in der Pivot-Tabelle angezeigten Daten wird durch die Einstellung für die Berücksichtigung der Groß-/Kleinschreibung für das Modell bestimmt. Bei Filtern in der Pivot-Tabelle wird die Groß-/Kleinschreibung jedoch nicht berücksichtigt, wenn der Filter für native Google Sheets-Daten nicht zwischen Groß- und Kleinschreibung unterscheidet.
  • Alle Nutzer mit Lesezugriff auf die Tabelle können die im Cache gespeicherten Daten in einer Pivot-Tabelle sehen.
  • Zusätzlich zum Bearbeitungszugriff auf die Tabelle benötigen alle Nutzer, die die Pivot-Tabelle bearbeiten oder aktualisieren müssen, die entsprechenden Berechtigungen in Looker, um auf das Datenmodell zuzugreifen. Dazu gehören der Zugriff auf das Modell, auf dem die Pivot-Tabelle basiert, die Berechtigungen zum Ansehen der Daten und der ordnungsgemäße Zugriff auf die Daten über Zugriffsfilter oder Zugriffsberechtigungen.
  • Wenn sich der Nutzer mit OAuth bei einer BigQuery-Datenbank authentifiziert, benötigt er möglicherweise Berechtigungen für die zugrunde liegende Datenbank.

Zeilen- und Datenlimits für verbundene Tabellenblätter

Abfragen, die mit verbundenen Tabellenblättern erstellt werden, dürfen maximal 100.000 Zeilen enthalten. Wenn das Ergebnis der Abfrage mehr Zeilen enthält, wird in Google Sheets ein Fehler angezeigt. Wenn der Nutzer nicht die Berechtigung download_without_limit hat, wird das Ergebnis unabhängig vom Limit in Google Sheets auf maximal 5.000 Zeilen gekürzt.

Außerdem unterliegen Abfragen in verbundenen Tabellenblättern einer Beschränkung der Datengröße. Abfragen, die zu viele Daten zurückgeben, führen ebenfalls zu einem Fehler.

Wenn einer dieser Fehler auftritt, sollten Sie Filter hinzufügen oder weniger und/oder weniger detaillierte Dimensionen in Ihrer Abfrage verwenden.

Fehlerbehebung bei verbundenen Tabellenblättern

Wenn Sie versuchen, von Google Sheets aus eine Verbindung zu Looker herzustellen, können Probleme auftreten. In diesem Abschnitt werden diese Probleme und ihre Behebung beschrieben.

Fehler: Beim Verbinden mit der Looker-Instanz ist ein Fehler aufgetreten. Bitte versuchen Sie es noch einmal. Wenn das Problem weiterhin auftritt, senden Sie uns bitte Feedback.

Dieser Fehler kann verschiedene Ursachen haben:

  • Der Name der Looker-Instanz wurde falsch eingegeben. Prüfen Sie in diesem Fall den Namen Ihrer Looker-Instanz und versuchen Sie noch einmal, eine Verbindung herzustellen.
  • Google Sheets kann keine Verbindung zur Looker API herstellen. Das kann passieren, wenn Ihre Looker-Instanz nicht die Standard-API-Host-URL verwendet. Lassen Sie das Feld API-Host-URL im API-Admin-Bereich leer, um dieses Problem zu beheben.

Fehler: Die Looker-Instanz ist nicht für die Verwendung dieser Funktion konfiguriert. Bitte wenden Sie sich an Ihren Looker-Administrator, um sicherzustellen, dass sie berechtigt ist.

Dieser Fehler kann verschiedene Ursachen haben:

  • Sie versuchen, eine Verbindung zu einer neu erstellten Looker-Instanz herzustellen. Es kann bis zu 24 Stunden dauern, bis eine neue Looker-Instanz in verbundenen Tabellenblättern verfügbar ist.
  • Sie versuchen, eine Verbindung zu einer Looker-Instanz herzustellen, die nicht von Looker gehostet wird. Stellen Sie eine Verbindung zu einer anderen Looker-Instanz her, die von Looker gehostet wird.

Nach dem Herstellen einer Verbindung zu einer Looker-Instanz werden keine Modelle angezeigt

Das bedeutet, dass Sie nicht die erforderlichen Berechtigungen zum Aufrufen von Modellen in Ihrer Instanz haben.

Ein Looker-Nutzer mit der Rolle „Betrachter“ hat nicht die erforderlichen Berechtigungen, um Verbindungen in Google Sheets zu erstellen, und auch nicht, um die Explore-Benutzeroberfläche in Looker zu verwenden. Wenn der Nutzer verbundene Tabellenblätter für Looker verwenden möchte, benötigt er die Berechtigung explore. Die Rollen „Admin“, „Developer“ und „User“ umfassen die Berechtigung explore. Ein Looker-Administrator kann dem Nutzer die Berechtigung explore erteilen. Dadurch sollte der Nutzer Modelle auf der Instanz sehen können.

Fehler: Die E-Mail-Adresse Ihres verknüpften Looker-Kontos stimmt nicht mit der E-Mail-Adresse Ihres Google-Kontos überein.

Das bedeutet, dass die E-Mail-Adresse Ihres Looker-Kontos nicht mit der E-Mail-Adresse Ihres Google-Kontos übereinstimmt. Achten Sie darauf, dass Sie in einem Google-Konto angemeldet sind, dessen E‑Mail-Adresse mit der Ihres Looker-Kontos übereinstimmt. Alternativ kann ein Looker-Administrator ein neues Looker-Nutzerkonto erstellen, das Ihre aktuelle Google-E-Mail-Adresse verwendet.

Fehler: Ungültige Anfrage: Kein aktivierter Client gefunden.

Dieser Fehler weist darauf hin, dass der Connector für verbundene Tabellenblätter nicht aktiviert wurde. Ein Looker-Administrator muss den vorkonfigurierten Verbundene Sheets-Client auf dem Tab Anwendungsbibliothek auf der Seite OAuth-Clients verwalten (Admin > Authentifizierung > OAuth-Clients verwalten) aktivieren oder im Admin-Menü von Looker im Bereich Plattform auf der Seite BI-Connectors entweder den Schalter Alle Looker-BI-Connectors oder Google Sheets aktivieren.

Fehler: 403 Forbidden

Wenn für Ihre Looker-Instanz eine IP-Zulassungsliste konfiguriert ist, kann diese verhindern, dass Google Sheets eine Verbindung zur Looker API herstellt. Um festzustellen, ob die Zulassungsliste die Ursache ist, rufen Sie die URL der Looker-Instanz auf und prüfen Sie, ob der Fehler IP-Adresse nicht auf der Zulassungsliste angezeigt wird.

  • Für Looker (Original)-Instanzen, die eine IP-Zulassungsliste verwenden, gibt es keine spezifische oder kuratierte statische Liste von Google Sheets-IP-Adressen, die der Zulassungsliste hinzugefügt werden können. Wenn Sie verbundene Tabellenblätter verwenden möchten, müssen Sie die IP-Zulassungsliste deaktivieren.
  • Bei Looker (Google Cloud Core)-Instanzen, die eine IP-Zulassungsliste verwenden, müssen Sie auf dem Tab Details der Instanz in der Google Cloud -Konsole das Kästchen Google-Dienste mit dieser Instanz verknüpfen anklicken.