Administratoreinstellungen – Self-Service-Explores

Mit der Funktion Self-Service-Explores können Ihre Looker-Nutzer CSV-, XLS- und XLSX-Dateien in Looker hochladen und die Daten dann in einem Looker-Explore abfragen und visualisieren, ohne ein LookML-Modell konfigurieren oder die Git-Versionsverwaltung einrichten zu müssen.

Looker-Administratoren können die Option Self-Service-Explores im Administratormenü von Looker auswählen, um die Funktion Self-Service-Explores zu konfigurieren und Daten-Uploads in der Instanz anzusehen.

Hinweis

Damit Sie Self-Service-Explores verwenden können, muss Ihre Looker-Instanz die folgenden Anforderungen erfüllen:

  • Sie verwenden Looker 25.20 oder höher für BigQuery-Verbindungen oder Looker 26.8 oder höher für Snowflake-Verbindungen.
  • Es muss eine Verbindung zu einer BigQuery- oder Snowflake-Datenbank bestehen und die Verbindung muss so konfiguriert sein:
    • Die Verbindung muss mit dem Bereich Alle Projekte konfiguriert werden. Den Umfang der Verbindung können Sie im Looker-Administratormenü auf der Seite Verbindungen auf dem Tab „Datenbanken“ in der Spalte Umfang sehen. Der Wert für Projektbereich der Verbindung kann nach dem Erstellen der Verbindung nicht mehr bearbeitet werden.
    • Die Verbindung muss für persistente abgeleitete Tabellen (PATs) aktiviert sein. Wenn Sie prüfen möchten, ob PDTs für die Verbindung aktiviert sind, öffnen Sie in Looker die Seite Verbindungen, klicken Sie für die Verbindung auf den Button Bearbeiten, öffnen Sie den Tab Optionale Einstellungen und prüfen Sie, ob der Ein/Aus-Schalter PDTs aktivieren aktiviert ist.
    • Bei Snowflake-Verbindungen muss ein Datenbankadministrator der Looker-Rolle CREATE STAGE gewähren. Weitere Informationen finden Sie auf der Dokumentationsseite Looker-Verbindung zu Snowflake erstellen.
  • Für alle Nutzer, die Self-Service-Explores erstellen, muss ihr Looker-Nutzerkonto die Berechtigung upload_data haben, mit der ein Nutzer CSV-Dateien in Ihre Instanz hochladen kann.

Beachten Sie die folgenden Einschränkungen beim Hochladen von Daten aus Google Sheets:

Self-Service-Explores aktivieren

Bevor Ihre Nutzer Self-Service-Explores erstellen können, muss ein Looker-Administrator das Feature konfigurieren. Gehen Sie dazu so vor:

  1. Wählen Sie im Looker-Administratormenü Admin im Bereich Allgemein die Seite Self-Service-Explores aus.
  2. Wählen Sie auf der Seite Self-service Explores (Self-Service-Explores) im Drop-down-Menü Default connection (Standardverbindung) die BigQuery- oder Snowflake-Verbindung aus, die zum Speichern der Daten für Self-Service-Explores verwendet werden soll. Looker speichert die Daten in dieser Datenbank für die Self-Service-Explores in Ihrer Instanz.
  3. Klicken Sie neben dem Ein/Aus-Schalter Daten hochladen auf den Button Testen, um zu prüfen, ob die Standardverbindung gültig ist und ob die Verbindung für persistente abgeleitete Tabellen (Persistent Derived Tables, PDTs) aktiviert ist. Informationen zu den Verbindungsanforderungen finden Sie im Abschnitt Vorbereitung. Wenn der Test fehlschlägt, können Sie das Hochladen von Daten nicht aktivieren. Rufen Sie die Admin-Seite „Verbindungen“ auf, um die Verbindung zu beheben.
  4. Wenn der Test bestanden ist, aktivieren Sie den Ein/Aus-Button Datenuploads, um die Self-Service-Funktion „Explores“ zu aktivieren.
  5. Wenn Ihre Looker-Instanz das Hochladen von Daten aus Google-Tabellen unterstützen soll:
    • Prüfen Sie, ob Sie eine BigQuery-Verbindung für Self-Service-Explores konfiguriert haben. Google Sheets-Uploads werden nur für BigQuery-Verbindungen unterstützt.
    • Aktivieren Sie die erforderlichen APIs für Google Tabellen-Uploads über die Google Cloud Console.
    • Optional: Aktivieren Sie OAuth für Google Sheets-Uploads, wenn Sie Ihren Nutzern die Möglichkeit geben möchten, eine Google Sheets-Datei für den Daten-Upload über die Google Drive-Navigation auszuwählen.
    • Klicken Sie neben dem Ein/Aus-Schalter Google Sheets-Datenimport auf die Schaltfläche Testen, um einen Test speziell für Google Sheets-Uploads auszuführen.
    • Aktivieren Sie die Ein/Aus-Schaltfläche Google Sheets-Datenimport. Sowohl die Ein/Aus-Schaltfläche Datenuploads als auch die Ein/Aus-Schaltfläche Google Sheets-Datenimport müssen aktiviert sein, damit Daten aus Google Sheets hochgeladen werden können.

APIs aktivieren, um Google Sheets-Uploads zu unterstützen

Damit Looker das Hochladen von Daten aus Google-Tabellen für BigQuery-Verbindungen unterstützt, müssen die folgenden APIs in der Google Cloud Console von einem IAM-Nutzer mit der IAM-Berechtigung roles/serviceusage.serviceUsageAdmin aktiviert werden:

  • Diese API muss in dem Google Cloud -Projekt aktiviert sein, das die BigQuery-Verbindung enthält, die im Drop-down-Menü Standardverbindung auf der Seite Self-Service-Explores angegeben ist:

    • BigQuery API: Für alle BigQuery-Vorgänge erforderlich

  • Diese APIs müssen in dem Google Cloud Projekt aktiviert sein, das mit dem Dienstkonto verknüpft ist, das zum Hochladen von Daten verwendet wird (das Dienstkonto, das für PDT-Prozesse in Ihrer BigQuery-Verbindung verwendet wird, das möglicherweise nicht mit dem Google Cloud Projekt identisch ist, das im Drop-down-Menü Standardverbindung auf der Seite Self-Service-Explores angegeben ist):

    • BigQuery API: Für alle BigQuery-Vorgänge erforderlich
    • Google Sheets API: Erforderlich, um die Namen der einzelnen Tabellenblätter in einem Google Sheets-Dokument abzurufen
    • Google Drive API: Erforderlich, damit BigQuery Dateien aus Drive lesen kann

Führen Sie die folgenden Schritte aus, um die APIs zu aktivieren:

  1. Wählen Sie in der Google Cloud Console über die Projektauswahl öffnen das Projekt aus, in dem sich die BigQuery-Verbindung befindet, die im Drop-down-Menü Standardverbindung auf der Admin-Seite Self-Service-Explores angegeben ist.

  2. Rufen Sie im Navigationsmenü der Google Cloud Console APIs & Services > Bibliothek auf und öffnen Sie die BigQuery API.

    Zur BigQuery API

  3. Wenn die API auf der Seite „BigQuery API“ noch nicht aktiviert ist, klicken Sie auf Aktivieren.

  4. Wählen Sie auf der BigQuery API-Seite in der Google Cloud Console über die Projektauswahl das Google Cloud -Projekt aus, das mit dem Dienstkonto verknüpft ist, das zum Hochladen von Daten verwendet wird (das Dienstkonto, das für PDT-Prozesse in Ihrer BigQuery-Verbindung verwendet wird).

  5. Wenn die API auf der Seite „BigQuery API“ noch nicht aktiviert ist, klicken Sie auf Aktivieren.

  6. Rufen Sie im Navigationsmenü der Google Cloud Console APIs & Dienste > Bibliothek auf und öffnen Sie die Google Sheets API.

    Zur Google Sheets API

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

  8. Rufen Sie im Navigationsmenü der Google Cloud Console APIs & Dienste > Bibliothek auf und öffnen Sie die Google Drive API.

    Zur Google Drive API

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

Konfiguration für Private Service Connect-Instanzen

Wenn für Ihre Looker (Google Cloud Core)-Instanz Private Service Connect (PSC) verwendet wird, müssen Sie einen zusätzlichen Schritt ausführen, um Google Tabellen-Uploads zu unterstützen.

Damit Looker auf die Google Sheets API zugreifen kann, müssen Sie Google Sheets als Dienst mit Private Service Connect veröffentlichen und dann Google Sheets der Einstellung „Lokaler FQDN“ in Ihrer Looker (Google Cloud Core)-Konfiguration hinzufügen. Verwenden Sie beim Konfigurieren des lokalen FQDN sheets.googleapis.com im Feld Local FQDN und den URI des Dienstanhangs des veröffentlichten Dienstes im Feld Target Service Attachment URI. Eine Anleitung finden Sie in der Dokumentation Mit lokalem FQDN eine Verbindung zu veröffentlichten Diensten herstellen.

OAuth für Google Sheets-Uploads aktivieren

Nachdem Sie Explores mit Self-Service aktiviert, die APIs zur Unterstützung von Google Sheets-Uploads aktiviert und die Ein/Aus-Schaltfläche Google Sheets-Datenimport aktiviert haben, können Sie Ihren Nutzern auch ermöglichen, Google Drive-Navigation zu verwenden, um Google Sheets-Dokumente für Daten-Uploads auszuwählen.

Damit die Google Drive-Navigation in Ihrer Looker-Instanz aktiviert werden kann, muss ein IAM-Nutzer mit den erforderlichen Rollen einen OAuth-Client in der Google Cloud Console erstellen und dann die OAuth-Anmeldedaten auf der Admin-Seite Self-Service-Explores in Ihrer Looker-Instanz eingeben. Das Verfahren wird in diesem Abschnitt beschrieben.

So erstellen Sie den OAuth-Client und geben die Anmeldedaten in Ihre Looker-Instanz ein:

  1. Wählen Sie in der Google Cloud Console mit der Google Cloud Console-Schaltfläche Projektauswahl öffnen das Google Cloud Projekt aus, das mit dem Dienstkonto verknüpft ist, das zum Hochladen von Daten verwendet wird (das Dienstkonto, das für PDT-Prozesse in Ihrer BigQuery-Verbindung verwendet wird).

    Zur Google Cloud Console

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

  3. Klicken Sie auf der Seite Anmeldedaten auf das Drop-down-Menü Anmeldedaten erstellen und wählen Sie 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 upload data from Sheets.

  6. Klicken Sie im Abschnitt Autorisierte JavaScript-Quellen auf die Schaltfläche URI hinzufügen. Geben Sie die URL Ihrer Looker-Instanz ein:

    https://LOOKER_INSTANCE_URL

  7. Klicken Sie auf Erstellen.

  8. 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 in der Google Cloud -Konsole für Ihren OAuth-Client erstellt wurden. Kopieren Sie diese Werte und notieren Sie sie sich.

  9. Wählen Sie in Ihrer Looker-Instanz im Bereich Admin im Abschnitt Allgemein die Option Self-Service-Explores aus.

  10. Fügen Sie auf der Seite Self-Service-Explores in die Felder Client-ID und Clientschlüssel die Werte ein, die Sie aus der Google Cloud -Konsole kopiert haben, als Sie den OAuth-Client in der Google Cloud -Konsole erstellt haben.

  11. Klicken Sie auf Speichern.

  12. Klicken Sie neben dem Ein/Aus-Schalter Google Sheets-Datenimport auf die Schaltfläche Testen, um die OAuth-Konfiguration zusätzlich zur Google Sheets-Uploadkonfiguration zu testen. Sie können auch auf den Button Testen neben dem Ein/Aus-Schalter Daten hochladen klicken, um die Verbindung zusätzlich zur Google-Tabellen-Konfiguration zu prüfen.

Wenn Ihre Nutzer jetzt Daten über die Option Aus Cloud importieren hochladen, wird in Looker die Google Drive-Navigation zum Auswählen von Google-Tabellen angezeigt.

Daten-Uploads in Ihrer Looker-Instanz ansehen

Wenn Self-Service-Explores für Ihre Instanz aktiviert sind, kann ein Looker-Administrator auf der Seite Self-Service-Explores in der Tabelle Daten hochladen die Daten ansehen, die Ihre Nutzer auf die Instanz hochgeladen haben.

In der Tabelle Daten-Uploads werden die folgenden Informationen zu den Daten-Uploads in Ihrer Instanz angezeigt:

  • Der Name des Self-Service-Explores, der auch ein Hyperlink ist, über den das Self-Service-Explore geöffnet wird
  • Der Inhaber des Datenuploads
  • Das Datum, an dem die Daten hochgeladen wurden
  • Eine Schaltfläche Löschen, mit der Looker-Administratoren den Dateiupload und das zugehörige Self-Service-Explore löschen können

Looker-Administratoren können jedes Self-Service-Explore in der Instanz über die Links in der Tabelle Daten hochladen öffnen. Im Bereich Self-Service-Explores des Looker-Menüs Explore werden jedoch nur die Self-Service-Explores aufgeführt, deren Inhaber Sie sind oder die der Inhaber speziell für Sie freigegeben hat. Im Menü Explore werden nicht alle Self-Service-Explores in der Instanz für Looker-Administratoren aufgeführt, da dies das Menü Explore unübersichtlich machen könnte.

Datenupload entfernen

Der Inhaber eines Datenuploads kann seinen Upload auf der Seite Self-Service-Explore bearbeiten entfernen. Außerdem kann ein Looker-Administrator einen Daten-Upload über die Seite Self-service Explores entfernen. Gehen Sie dazu so vor:

  1. Wählen Sie im Looker-Administratormenü Admin im Bereich Allgemein die Seite Self-Service-Explores aus.
  2. Klicken Sie in der Tabelle Daten-Uploads für den Daten-Upload, den Sie entfernen möchten, auf den Button Löschen.
  3. Klicken Sie im Bestätigungsdialogfeld auf Löschen.