Verbundene Tabellenblätter für Looker verwenden

Mit verbundenen Tabellenblättern für Looker können Nutzer Daten aus LookML-Modellen über die vertraute Google Sheets-Tabellenoberfläche interaktiv analysieren. Sheets-Nutzer haben Zugriff auf verwaltete Daten aus über 50 von Looker unterstützten Datenbanken. Die Analyse ist intuitiv, da in verbundenen Tabellenblättern eine übersichtliche Ansicht des Modells mit Ansichten, Feldern und Messwerten angezeigt wird, die genau wie in Looker definiert sind. Looker-Daten können über verbundene Tabellenblätter in Standardkonstrukten von Google Sheets wie Pivot-Tabellen, Diagrammen und Formeln verwendet werden. So lassen sich Analysen flexibel mit vertrauten Konstrukten durchführen.

Verbundene Tabellenblätter aktivieren

So verwenden Sie verbundene Tabellenblätter:

  • In Looker (Original) muss Ihr Looker-Administrator entweder die Ein/Aus-Schaltfläche Alle Looker-BI-Connectors oder Verbundene Tabellenblätter 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-Instanz muss von Looker gehostet werden.
  • Auf Ihrer Looker-Instanz muss Looker 22.20 oder höher ausgeführt werden, wenn Ihre Instanz auf Google Cloudgehostet wird. Wenn Ihre Looker-Instanz nicht auf Google Cloudgehostet wird, muss auf Ihrer Instanz Looker 23.4 oder höher ausgeführt werden.
  • Jeder Nutzer, der eine Verbindung zu Ihrer Looker-Instanz über Google Tabellen herstellen möchte, muss in seinem Looker-Nutzerkonto dieselbe E-Mail-Adresse verwenden wie für sein Google Workspace-Konto. Wenn die E‑Mail-Adressen für ihr Google Workspace- und ihr Looker-Konto unterschiedlich sind, erhalten sie eine Fehlermeldung, wenn sie versuchen, eine Verbindung zu Looker über Google Tabellen herzustellen.
  • Der Zugriff auf Dienste, die nicht einzeln gesteuert werden, muss in der Google Workspace-Admin-Konsole aktiviert sein. Diese Einstellung ist in der Regel standardmäßig aktiviert. Weitere Informationen finden Sie im Hilfeartikel Dienste ohne eigene Steuerung verwalten.

Mit einem Look aus Google Sheets verbinden

In Looker ist ein Look eine einzelne Abfrage, die zuvor gespeichert wurde. Sie können die Ergebnisse eines Looks in ein Tabellenblatt einfügen und dann in Google Tabellen damit arbeiten.

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

  2. Geben Sie im Dialogfeld Verbindung zu Looker herstellen den Namen Ihrer Looker-Instanz ein oder wählen Sie den Namen einer Instanz aus, mit der Sie kürzlich eine Verbindung hergestellt haben, und klicken Sie auf Verbindung zu Looker herstellen.

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

  4. Wählen Sie im Dialogfeld Mit 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 klicken Sie auf Erstellen.

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

Looks können in Google Tabellen nicht bearbeitet werden. Sie können die Look-Daten aber 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 aufrufen.

Verbindung zu Looker-Explores ü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 einem Tabellenblatt zu erstellen.

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

  2. Geben Sie im Dialogfeld Verbindung zu Looker herstellen den Namen Ihrer Looker-Instanz ein oder wählen Sie den Namen einer Instanz aus, mit der Sie kürzlich eine Verbindung hergestellt haben, und klicken Sie auf Verbindung zu Explore herstellen.

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

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

Looker-Abfragen mit Google Sheets erstellen

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

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

  2. Wählen Sie aus, ob eine neue Pivot-Tabelle in ein neues oder ein vorhandenes Tabellenblatt eingefügt werden soll, 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 auf Grundlage der Dimensionen und Messwerte in Ihrem Looker-Explore zu erstellen.

    Die Zeilen, Spalten, Werte und Filter im Pivot-Editor entsprechen Ihren Looker-Dimensionen und ‑Messwerten auf folgende Weise:

    Im Pivot-Editor wird auch eine Liste der Ansichten angezeigt, die Teil Ihrer explorativen Datenanalyse sind. Sie können eine Ansicht auswählen, um die darin enthaltenen Dimensionen und Messwerte aufzurufen.

  3. Wählen Sie Hinzufügen aus, um eine Zeile, 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, aus dem die Daten für Zeile, Spalte, Wert oder Filter stammen.

  4. Nachdem Sie Ihre Looker-Felder und -Filter hinzugefügt haben, um die Abfrage zu erstellen, wählen Sie Übernehmen aus. Dadurch werden die Daten aus Ihrer Looker-Instanz in das Tabellenblatt eingefügt.

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

Filteroptionen

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

Nach Wert filtern

Sie können Looker-Dimensionen in Pivot-Tabellen in verbundenen Tabellenblättern für Looker filtern, indem Sie eine Liste mit Werten aufrufen und die gewünschten Werte auswählen bzw. 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 der Pivot-Tabelle im Bereich Filter ein Feld hinzu und klicken Sie auf das Drop-down-Menü Status, um die Filteroptionen zu öffnen. Klicken Sie dann auf Filter hinzufügen:

Eine Seitenleiste wird geöffnet und Sheets ruft die 500 am häufigsten vorkommenden Werte aus Looker ab.

Sie können dann in 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 Tabellen gespeichert. Klicken Sie dann auf Übernehmen, um die Pivot-Tabelle wie gewohnt mit dem neuen Filter zu aktualisieren.

Filter mit Looker-Filterausdrücken

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

So verwenden Sie Looker-Filterausdrücke:

  1. Fügen Sie der Pivot-Tabelle ein Feld im Bereich „Filter“ 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 dem Filtern nach relativen Datumsangaben sind jetzt auch folgende Filterungen möglich:

  • Ein String, der nicht mit -FOO% beginnt.
  • Ein numerischer Bereich mit einbezogenem und ausgeschlossenem Wert: (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 Field Picker in Google Tabellen im Bereich NUR-FILTER-FELDER angezeigt, genau 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. Das funktioniert genauso wie beim Filtern nach einer Dimension oder einem Messwert.
  2. Für Parameter mit zulässigen Werten werden diese Werte in einem Drop-down-Menü im Dialogfeld Nach Bedingung filtern angezeigt.
  3. Für reine Filterfelder können Sie das reguläre Dialogfeld Nach Bedingung filtern verwenden. Wenn für das Feld Vorschläge im Looker-Modell 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 aktuellen Daten.

Sowohl Ihre Pivot-Tabelle als auch das Tabellenblatt mit Ihrem Look oder Explore zeigen an, wann sie zuletzt aktualisiert wurden.

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 oder Aktualisierungsoptionen in Ihrem Explore-Tabellenblatt aus. Das Dialogfeld Geplante Aktualisierung wird angezeigt.

Pivot-Tabelleneinstellungen bearbeiten

Wenn Sie ändern möchten, welche Zeilen, Spalten, Werte oder Filter in Ihre Pivot-Tabelle aufgenommen werden, wählen Sie das Stiftsymbol neben dem Dreipunkt-Menü aus, um den Editorbereich für Pivot-Tabellen zu öffnen.

Verbundene Tabellenblätter überwachen

Ein Looker-Administrator kann die Nutzung von Connected Sheets mit der Feldgruppe Query API Client Properties (Client-Eigenschaften der Query API) im System Activity History Explore (Explore „Systemaktivität – Verlauf“) ansehen. Jedes Mal, wenn eine neue Abfrage ausgeführt wird, wird ein Eintrag in der explorativen Datenanalyse Verlauf erstellt.

In der Gruppe von Feldern Query API Client Properties (API-Clientattribute abfragen) gibt es drei neue Felder für Connected Sheets:

  • API Client Name (API-Clientname): In diesem Feld wird immer Connected Sheets angezeigt, um Connected Sheets-Einträge zu kennzeichnen.
  • ID für verbundene Tabellenblätter: In diesem Feld wird die Tabellenblatt-ID angezeigt, die in der Google Sheets-URL für das entsprechende Tabellenblatt enthalten ist.
  • Connected Sheets Trigger (Trigger für verbundene Tabellenblätter): In diesem Feld wird angezeigt, ob die Abfrage ausgelöst wurde, weil ein Nutzer in Google Tabellen auf die Schaltfläche Aktualisieren geklickt hat, oder durch eine geplante Aktualisierung.

Im Folgenden finden Sie ein Beispiel für eine Systemaktivitäts-URL, die die Verwendung von Connected Sheets 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

Der API-Support für Connected Sheets für Looker ist sowohl über AppsScript als auch über die Google Sheets APIs verfügbar.

Mit API-Unterstützung können Sie unter anderem Folgendes programmatisch erledigen:

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

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

Wichtige Informationen

  • Die Berücksichtigung der Groß- und Kleinschreibung für die in der Pivot-Tabelle angezeigten Daten wird durch die Einstellung für die Berücksichtigung der Groß- und Kleinschreibung für das Modell bestimmt. Filter in der Pivot-Tabelle erzwingen jedoch die Nichtberücksichtigung der Groß-/Kleinschreibung in Situationen, in denen der Filter für native Sheets-Daten die Groß-/Kleinschreibung nicht berücksichtigt.
  • Jeder, der Lesezugriff auf das Tabellenblatt hat, kann die im Cache gespeicherten Daten in einer Pivot-Tabelle ansehen.
  • Zusätzlich zum Editorzugriff auf das Tabellenblatt benötigen alle Nutzer, die die Pivot-Tabelle bearbeiten oder aktualisieren müssen, die richtigen Berechtigungen in Looker, um auf das Datenmodell zuzugreifen. Dazu gehören Zugriff auf das Modell, auf dem die Pivot-Tabelle basiert, Berechtigungen zum Ansehen der Daten und ordnungsgemäßer Zugriff auf die Daten über Zugriffsfilter oder Zugriffsberechtigungen.
  • Wenn sich der Nutzer mit OAuth bei einer BigQuery-Datenbank authentifiziert, müssen ihm möglicherweise Berechtigungen für die zugrunde liegende Datenbank erteilt werden.

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 Tabellen eine Fehlermeldung angezeigt. Wenn der Nutzer nicht die Berechtigung download_without_limit hat, wird das Ergebnis unabhängig vom Sheets-Limit auf maximal 5.000 Zeilen gekürzt.

Außerdem unterliegen Connected Sheets-Abfragen einem Datenmengenlimit. Abfragen, die zu viele Daten zurückgeben, führen ebenfalls zu einem Fehler.

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

Fehlerbehebung bei verbundenen Tabellenblättern

Beim Herstellen einer Verbindung zu Looker aus Google Sheets 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. Versuchen Sie es bitte noch einmal. Wenn das Problem weiterhin auftritt, senden Sie uns bitte Feedback.

Dieser Fehler kann aus verschiedenen Gründen auftreten:

  • 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 für Ihre Looker-Instanz nicht die Standard-API-Host-URL verwendet wird. Lassen Sie dazu das Feld API-Host-URL im API-Adminbereich leer.

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 aus verschiedenen Gründen auftreten:

  • Sie versuchen, eine Verbindung zu einer neu erstellten Looker-Instanz herzustellen. Es kann bis zu 24 Stunden dauern, bis eine neue Looker-Instanz in Connected Sheets verfügbar ist.
  • Sie versuchen, eine Verbindung zu einer Looker-Instanz herzustellen, die nicht von Looker gehostet wird. Verbindung zu einer anderen Looker-Instanz herstellen, 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 haben, um Modelle in Ihrer Instanz aufzurufen.

Ein Looker-Nutzer mit der Rolle „Betrachter“ hat nicht die erforderlichen Berechtigungen, um Verbindungen in Google Tabellen zu erstellen, ebenso wie er nicht die erforderlichen Berechtigungen hat, 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 Berechtigung explore ist in den Rollen „Administrator“, „Entwickler“ und „Nutzer“ enthalten. Ein Looker-Administrator kann dem Nutzer die Berechtigung explore gewähren. Dadurch sollte der Nutzer Modelle in 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 übereinstimmt, die Sie für Ihr Google-Konto verwenden. Sie müssen mit einem Google-Konto angemeldet sein, dessen E-Mail-Adresse mit Ihrem Looker-Konto übereinstimmt. Alternativ kann ein Looker-Administrator ein neues Looker-Nutzerkonto mit Ihrer aktuellen Google-E‑Mail-Adresse erstellen.

Fehler: Ungültige Anfrage: Kein Aktivierungsclient gefunden.

Dieser Fehler gibt an, dass der Connector für verbundene Tabellenblätter nicht aktiviert wurde. Ein Looker-Administrator muss im Bereich „BI-Connectors“ im Admin-Menü von Looker im Bereich Plattform entweder die Ein/Aus-Schaltfläche Alle Looker-BI-Connectors oder Connected Sheets aktivieren.

Fehler: 403 Forbidden

Wenn für Ihre Looker-Instanz eine IP-Zulassungsliste konfiguriert ist, kann diese verhindern, dass Sheets eine Verbindung zur Looker API herstellt. Um festzustellen, ob die Zulassungsliste die Ursache ist, rufen Sie die Looker-Instanz-URL auf. Wenn Sie den Fehler IP Address Not on Allowlist (IP-Adresse nicht auf der Zulassungsliste) erhalten, ist die Zulassungsliste die Ursache.