Administratoreinstellungen – Self-Service-Explores

Mit der Funktion Self-Service-Explores können 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-Versionskontrolle einrichten zu müssen.

Looker-Administratoren können im Looker-Menü Admin die Option Self-Service-Explores auswählen, um die Funktion Self-Service-Explores zu konfigurieren und Datenuploads in der Instanz anzusehen.

Hinweis

Wenn Sie Self-Service-Explores verwenden möchten, muss Ihre Looker-Instanz die folgenden Anforderungen erfüllen:

  • Looker 25.20 oder höher für BigQuery-Verbindungen oder Looker 26.8 oder höher für Snowflake-Verbindungen.
  • Eine Verbindung zu einer BigQuery- oder Snowflake-Datenbank. Die Verbindung muss so konfiguriert sein:
    • Die Verbindung muss mit dem Bereich Alle Projekte konfiguriert sein. Den Bereich der Verbindung können Sie auf dem Tab Datenbanken tab der Seite Verbindungen im Looker-Adminmenü in der Spalte Scope überprüfen. 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 (PDTs) aktiviert sein. Um zu überprüfen, ob PDTs für die Verbindung aktiviert sind, öffnen Sie die Looker-Verbindungen-Seite, klicken Sie für die Verbindung auf die Schaltfläche Bearbeiten, öffnen Sie den Tab Optionale Einstellungen und prüfen Sie, ob der Ein/Aus-Button PDTs aktivieren aktiviert ist.
    • Bei BigQuery-Verbindungen, die die Authentifizierung mit OAuth verwenden, müssen Nutzer die Berechtigung haben, Tabellen im Scratch-Schema anzusehen, um hochgeladene Daten zu sehen. Diese Konfiguration ist dieselbe, die erforderlich ist, damit Nutzer persistente abgeleitete Tabellen (PDTs) mit einer OAuth-Verbindung verwenden können.
  • Bei Snowflake-Verbindungen muss ein Datenbankadministrator der Looker-Rolle CREATE STAGE gewähren. Weitere Informationen finden Sie auf der Dokumentationsseite zum Erstellen einer Looker-Verbindung zu Snowflake.
  • Für jeden Nutzer, der Self-Service-Explores erstellt, muss sein Looker-Nutzerkonto die upload_data Berechtigung haben, mit der er CSV-Dateien in Ihre Instanz hochladen kann.

Beachten Sie die folgenden Einschränkungen für das Hochladen von Daten aus Google Sheets:

Self-Service-Explores aktivieren

Bevor Ihre Nutzer Self-Service-Explores erstellen können, muss ein Looker-Administrator die Funktion konfigurieren. Führen Sie dazu die folgenden Schritte aus:

  1. Wählen Sie im Bereich Allgemein des Looker-Menüs Admin die Adminseite Self-Service-Explores aus.
  2. Wenn Sie Ihren Nutzern ermöglichen möchten, für ihre Datenuploads aus mehreren Verbindungen auszuwählen, aktivieren Sie auf der Adminseite Self-Service-Explores die Option Erweiterte Verbindungsverwaltung. Weitere Informationen finden Sie im Abschnitt Erweiterte Verbindungsverwaltung.
  3. Konfigurieren Sie eine oder mehrere Verbindungen für Self-Service-Uploads:
    • Wenn Einzelne Standardverbindung aktiviert ist, wählen Sie im Drop-down-Menü Standardverbindung die 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.
    • Wenn Erweiterte Verbindungsverwaltung aktiviert ist, suchen Sie in der Tabelle Verbindungen die Verbindung(en), die Sie für Self-Service-Uploads verwenden möchten, und aktivieren Sie für jede Verbindung, die Datenuploads unterstützen soll, den Ein/Aus-Button für Datenupload aktivieren. Wenn ein Nutzer einen Self-Service-Explore erstellt, kann er in Looker aus einer Liste der aktivierten Verbindungen auswählen, auf die er Zugriff hat, und die Daten in der angegebenen Datenbank speichern.

  4. Klicken Sie auf die Schaltfläche Testen , um die Verbindungskonfiguration zu überprüfen:

    • Wenn Einzelne Standardverbindung aktiviert ist, klicken Sie neben dem Ein/Aus-Button Datenuploads auf die Schaltfläche Testen , um zu prüfen, ob die Standardverbindung gültig ist und ob die Verbindung für persistente abgeleitete Tabellen (PDTs) aktiviert ist. Die Anforderungen an die Verbindung finden Sie im Abschnitt Hinweis.
    • Wenn Erweiterte Verbindungsverwaltung aktiviert ist, klicken Sie in der Tabelle Verbindungen neben jeder aktivierten Verbindung auf die Schaltfläche Testen.

    Wenn der Test fehlschlägt, können Sie Datenuploads für diese Verbindung nicht aktivieren. Rufen Sie die Adminseite Verbindungen auf, um das Problem mit der Verbindung zu beheben.

  5. Wenn die Tests erfolgreich sind, aktivieren Sie den Ein/Aus-Button Datenuploads , um die Funktion „Self-Service-Explores“ zu aktivieren.

  6. Wenn Ihre Looker-Instanz das Hochladen von Daten aus Google Sheets unterstützen soll, gehen Sie so vor:

    • 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 in der Google Cloud Console die erforderlichen APIs, um Google Sheets-Uploads zu unterstützen.
    • Aktivieren Sie optional OAuth für Google Sheets-Uploads, wenn Sie Ihren Nutzern ermöglichen möchten, über die Google Drive-Navigation eine Google Sheets-Datei für den Datenupload auszuwählen.
    • Testen und aktivieren Sie Google Sheets-Uploads:
      • Wenn Einzelne Standardverbindung aktiviert ist, klicken Sie neben dem Ein/Aus-Button Google Sheets-Datenimport auf die Schaltfläche Testen , um die Verbindung für Google Sheets-Uploads zu testen. Wenn der Test erfolgreich ist, aktivieren Sie den Ein/Aus-Button Google Sheets-Datenimport.
      • Wenn Erweiterte Verbindungsverwaltung aktiviert ist, klicken Sie in der Tabelle Verbindungen für jede Verbindung, die Sie für Google Sheets-Uploads aktivieren möchten, auf die Schaltfläche Testen für Google Sheets-Importe. Wenn der Test für eine Verbindung erfolgreich ist, aktivieren Sie für die Verbindung den Ein/Aus-Button Google Sheets-Importe. Damit Daten aus Google Sheets hochgeladen werden können, müssen sowohl der Ein/Aus-Button Datenuploads als auch der Ein/Aus-Button Google Sheets-Importe aktiviert sein.

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

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

  • Diese API muss in dem Google Cloud Projekt aktiviert sein, in dem sich die BigQuery-Verbindung befindet, die im Standardverbindung Drop-down-Menü der Self-Service-Explores Adminseite 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 für Ihre BigQuery-Verbindung verwendet wird. Dies kann dasselbe Google Cloud Projekt sein, das im Drop-down-Menü Standardverbindung der Adminseite 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 Projektauswahl öffnen das Projekt aus, in dem sich die BigQuery-Verbindung befindet, die im Drop-down-Menü Standardverbindung der Adminseite Self-Service-Explores angegeben ist.

  2. Rufen Sie im Google Cloud Navigationsmenü derConsole APIs und Dienste > 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 Seite „BigQuery API“ in der Google Cloud Console 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 für Ihre 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 Google Cloud Navigationsmenü derConsole APIs und Dienste > Bibliothek auf und öffnen Sie die Google Sheets API.

    Zur Google Sheets API

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

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

    Zur Google Drive API

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

Konfiguration für Private Service Connect-Instanzen

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

Damit Looker die Google Sheets API erreichen 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 Lokaler FQDN und die Dienstanhang-URI des veröffentlichten Dienstes im Feld Ziel-Dienstanhang-URI. Eine Anleitung finden Sie in der Dokumentation unter Verbindung zu veröffentlichten Diensten über lokalen FQDN herstellen.

OAuth für Google Sheets-Uploads aktivieren

Nachdem Sie Self-Service-Explores aktiviert, die APIs zur Unterstützung von Google Sheets-Uploads aktiviert und den Ein/Aus-Button Google Sheets-Datenimport aktiviert haben, können Sie Ihren Nutzern auch ermöglichen, über die Google Drive-Navigation Google Sheets-Dokumente für Datenuploads auszuwählen.

Damit die Google Drive-Navigation in Ihrer Looker-Instanz aktiviert werden kann, muss ein IAM-Nutzer mit den erforderlichen Rollen in der Google Cloud Console einen OAuth-Client erstellen und dann die OAuth-Anmeldedaten auf der Adminseite Self-Service-Explores in Ihrer Looker-Instanz eingeben. Die Schritte dazu finden Sie in diesem Abschnitt.

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

  1. Wählen Sie in der Google Cloud Console mit der Google Cloud Console-Option 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 für Ihre BigQuery-Verbindung verwendet wird).

    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 upload data from Sheets.

  6. Klicken Sie im Bereich 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 Console für Ihren OAuth-Client erstellt wurden. Kopieren Sie diese Werte und notieren Sie sie.

  9. Wählen Sie in Ihrer Looker-Instanz im Bereich Allgemein des Menüs Admin 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 beim Erstellen des OAuth-Clients in der Google Cloud Google Cloud Console kopiert haben.

  11. Klicken Sie auf Speichern.

  12. Klicken Sie neben dem Ein/Aus-Button Google Sheets-Datenimport auf die Schaltfläche Testen , um neben der Google Sheets-Uploadkonfiguration auch die OAuth-Konfiguration zu testen. Sie können auch neben dem Ein/Aus-Button Datenuploads auf die Schaltfläche Testen klicken, um neben der Google Sheets-Konfiguration auch die Verbindung zu testen.

Wenn Ihre Nutzer jetzt Daten mit der Option Aus der Cloud importieren hochladen, wird in Looker die Google Drive-Navigation angezeigt, damit sie Google Sheets-Dokumente auswählen können.

Erweiterte Verbindungsverwaltung

Standardmäßig werden Self-Service-Explores in einer einzelnen Standarddatenbankverbindung gespeichert, die von einem Looker-Administrator angegeben wird. Wenn Sie jedoch auf der Adminseite Self-Service-Explores die Option Erweiterte Verbindungsverwaltung aktivieren, können Sie Ihre Instanz mit mehreren Datenbankverbindungen zum Speichern von Self-Service-Explore-Daten konfigurieren. Unter Erweiterte Verbindungsverwaltung können nur Nutzer, die Berechtigungen für eine zulässige Verbindung haben, diese Verbindung auswählen, um ihre hochgeladenen Daten zu speichern und abzufragen.

Mehrere Verbindungen aktivieren

Wenn Erweiterte Verbindungsverwaltung aktiviert ist, wird auf der Adminseite Self-Service-Explores eine Tabelle Verbindungen mit allen Datenbankverbindungen in Ihrer Instanz angezeigt, die die Anforderungen für Self-Service-Explores erfüllen. In dieser Tabelle kann ein Looker-Administrator für jede Verbindung die folgenden Aktionen ausführen:

  • Bestimmte Uploadabläufe mit den Ein/Aus-Buttons in der Spalte Datenupload aktivieren (für Dateiuploads) und der Spalte Google Sheets-Importe (für Google Sheets-Uploads) aktivieren oder deaktivieren.
  • Die Gültigkeit der Verbindung und den Status der persistenten abgeleiteten Tabelle (PDT) testen, indem Sie in der Spalte Datenupload aktivieren auf die Schaltfläche Testen klicken. Außerdem können Sie die Verbindung auf die Konfiguration für Google Sheets-Uploads testen.

Verbindung während des Uploads auswählen

Wenn ein Nutzer einen Datenupload über den Tab Von lokal hochladen oder den Tab Aus der Cloud importieren im Dialogfeld Datenquelle erstellen startet, muss er zuerst eine Verbindung auswählen. Nutzer können in einer Drop-down-Liste zulässiger Verbindungen auswählen. Looker filtert diese Liste so, dass ein Nutzer nur die Verbindungen sieht, die für die Verwendung durch Modelle konfiguriert sind, für die er die upload_data Berechtigung hat. Der Nutzer kann keine Daten in eine andere Verbindung hochladen.

Nutzerberechtigungen und Verbindungszugriff

Unter Erweiterte Verbindungsverwaltung ist der fortlaufende Zugriff auf Self-Service-Datenuploads streng an die zugrunde liegende Datenbankverbindung gebunden:

  • Fortlaufender Zugriff auf vorhandene Uploads: Für die meisten Nutzeraktionen für einen Datenupload nach der Erstellung ist ein fortlaufender Zugriff auf die zugrunde liegende Verbindung erforderlich. Wenn der Zugriff eines Nutzers auf eine Datenbankverbindung widerrufen wird, kann er keine Self-Service-Explores mehr ansehen, abfragen, bearbeiten oder mit anderen teilen, die diese Verbindung verwenden, auch wenn er die Daten ursprünglich hochgeladen hat. Der Self-Service-Explore funktioniert weiterhin für andere Nutzer, die noch Zugriff auf die Verbindung haben.
  • Abfragezugriff: Für den fortlaufenden Abfragezugriff auf einen Self-Service-Explore muss der Nutzer die Berechtigung access_data für mindestens ein LookML-Modell haben, das so konfiguriert ist, dass die zugrunde liegende Datenbankverbindung für diesen Upload verwendet wird.
  • Self-Service-Explores freigeben: Nutzer können einen Self-Service-Explore nur für andere Nutzer oder Gruppen freigeben, die die access_data Berechtigung für ein LookML-Modell haben, das so konfiguriert ist, dass die zugrunde liegende Datenbankverbindung für diesen Upload verwendet wird.

Adminberechtigungen

Looker-Administratoren (Nutzer mit der Rolle „Looker-Administrator“) haben die Berechtigung upload_data für alle Modelle in der Instanz. Administratoren können sehen, welche Datenuploads in einer Looker-Instanz vorhanden sind. Um einen Self-Service-Explore anzusehen oder zu bearbeiten, muss dem Administrator jedoch eine Rolle mit Zugriff auf dieses bestimmte Self-Service-Modell zugewiesen werden.

Erweiterte Verbindungsverwaltung deaktivieren

Wenn Sie Erweiterte Verbindungsverwaltung in einer Instanz deaktivieren, in der sie zuvor aktiviert war, beachten Sie die folgenden Auswirkungen:

  • Weniger strenge Autorisierung: Das Autorisierungsmodell wird weniger streng. Da die Governance auf Verbindungsebene nicht mehr erzwungen wird, können Self-Service-Datenuploads für jeden Nutzer in der Instanz freigegeben werden.
  • Abfragezugriff: Nutzer können weiterhin vorhandene Self-Service-Datenuploads abfragen, auf die sie Zugriff hatten, bevor Erweiterte Verbindungsverwaltung deaktiviert wurde.
  • Rollenänderungen: Die Steuerelemente für die Verbindungsverwaltung sind deaktiviert. Das bedeutet, dass zukünftige Änderungen an Rollen oder Berechtigungen den Zugriff auf vorhandene Self-Service-Datenuploads nicht einschränken.
  • Anforderung für Standardverbindung: Wenn Erweiterte Verbindungsverwaltung deaktiviert ist, können Nutzer Daten nur in die einzelne Verbindung hochladen, die im Drop-down-Menü Standardverbindung ausgewählt ist. Wenn in Ihrer Instanz nur Self-Service-Uploads verwendet wurden, während Erweiterte Verbindungsverwaltung aktiviert war, wurde möglicherweise noch keine Standardverbindung ausgewählt. Ein Looker-Administrator muss eine Standardverbindung auswählen und testen, wenn er die Funktion wieder aktivieren möchte, damit Self-Service-Uploads weiterhin funktionieren.

Datenuploads in Ihrer Looker-Instanz ansehen

Wenn Self-Service-Explores in Ihrer Instanz aktiviert sind, kann ein Looker-Administrator in der Tabelle Datenuploads auf der Adminseite Self-Service-Explores die Daten ansehen, die Ihre Nutzer in die Instanz hochgeladen haben.

Die Tabelle Datenuploads enthält die folgenden Informationen zu den Datenuploads in Ihrer Instanz:

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

Looker-Administratoren können jeden Self-Service-Explore in der Instanz über die Links in der Tabelle Datenuploads öffnen. Im Bereich Self-Service-Explores des Looker-Menüs Explore werden jedoch nur die Self-Service-Explores aufgeführt, die Ihnen gehören oder die der Eigentümer 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 Eigentümer eines Datenuploads kann seinen Upload auf der Seite Self-Service-Explore bearbeiten entfernen. Außerdem kann ein Looker-Administrator einen Datenupload auf der Adminseite Self-Service-Explores entfernen. Führen Sie dazu die folgenden Schritte aus:

  1. Wählen Sie im Bereich Allgemein des Looker-Menüs Admin die Adminseite Self-Service-Explores aus.
  2. Klicken Sie in der Tabelle Datenuploads für den Datenupload, den Sie entfernen möchten, auf die Schaltfläche Löschen.
  3. Klicken Sie im Bestätigungsdialogfeld auf Löschen.