Administratoreinstellungen – Verbindungen

Um auf die Seite Verbindungen zuzugreifen, öffnen Sie das Menü Verwaltung und wählen Sie unter Datenbank die Option Verbindungen aus.

Verbindungen ansehen

Auf der Seite Verbindungen können Sie Ihre Datenbankverbindungen und die IP-Adressen aufrufen, die zum Zulassen von Netzwerk-Traffic erforderlich sind. Wenn die Möglichkeit, eine neue Datenbank zu erstellen, für Ihre Instanz aktiviert wurde, können Sie auch eine neue Verbindung hinzufügen.

Tab „Datenbanken“

Auf dem Tab Datenbanken werden grundlegende Informationen zu den von Ihnen definierten Datenbankverbindungen angezeigt. Außerdem werden alle von Looker verwalteten Verbindungen angezeigt, die Sie erstellt haben, sofern die Möglichkeit, eine neue Datenbank zu erstellen, für Ihre Instanz aktiviert wurde. Sie können den Status dieser Verbindungen auch auf dem Tab Datenbanken testen und die Konfiguration bearbeiten.

Sie können auf Öffentliche IP-Adressen klicken, um die Liste der IP-Adressen aufzurufen, die erforderlich sind, um Netzwerkverkehr von Ihrer Looker-Instanz zuzulassen. Jeglicher Netzwerk-Datenverkehr von Looker stammt je nach Region, in der Ihre Looker-Instanz gehostet wird, von einer der aufgeführten IP-Adressen. Sie können den Datenzugriff beschränken, indem Sie Datenverkehr zu Ihrer Datenbank nur von diesen und anderen vertrauenswürdigen IP-Adressen zulassen.

In der folgenden Tabelle werden die Elemente auf dem Tab Datenbanken beschrieben:

Spalte Beschreibung
Name Der von Ihnen gewählte Name der Verbindung, der im LookML-Parameter connection verwendet wird. Wenn Sie die Verbindung testen, wird in Looker die Liste der Statusprüfungen unter dem Verbindungsnamen angezeigt.
Datenbank Der Name der Datenbank, die von Looker bei Verwendung dieser Verbindung abgefragt wird.
Umfang Gibt an, ob die Verbindung mit allen Projekten oder nur mit einem bestimmten Projekt verwendet werden kann.
SSH-Server Der Name der SSH-Serverkonfiguration, die zum Erstellen eines SSH-Tunnels zu Ihrer Datenbank verwendet wird. Diese Spalte wird nur angezeigt, wenn der Tab SSH-Server in Ihrer Looker-Instanz aktiviert ist.
SSL Ob Sie SSL-Verschlüsselung verwenden, um die Daten zu schützen, die zwischen Looker und Ihrer Datenbank übertragen werden (neben SSL gibt es weitere sichere Optionen).
Typ Der SQL-Dialekt der Datenbankverbindung.
Aktionen Folgende Aktionen sind für eine Verbindung möglich: Verbindung testen, Verbindung bearbeiten, andere Informationen zur Verbindung ansehen, zu einer Liste von Links zu den Explores der Verbindung springen oder eine Verbindung löschen. Wenn die Möglichkeit zum Erstellen einer neuen Datenbank für Ihre Instanz aktiviert wurde, können Sie auch Daten aus einer zusätzlichen Datenquelle zu von Looker verwalteten Verbindungen hinzufügen.

Tab „SSH-Server“

Der Tab SSH-Server ist für Looker (Google Cloud Core)-Instanzen nicht verfügbar.

Die Option SSH-Server ist verfügbar, wenn eine Looker-Instanz (Original) in einer Kubernetes-Infrastruktur bereitgestellt wird, und nur dann, wenn die Fähigkeit aktiviert wurde, Ihrer Looker-Instanz Informationen zur SSH-Serverkonfiguration hinzuzufügen. Wenn diese Option in Ihrer Looker-Instanz nicht aktiviert ist und Sie sie aktivieren möchten, wenden Sie sich an einen Google Cloud Vertriebsexperten oder stellen Sie eine Supportanfrage.

Looker wählt den localhost-Port automatisch für Sie aus, wenn SSH-Tunnel erstellt werden. Sie können den localhost-Port nicht angeben.

Für SSH-Verbindungen zu PrestoDB- oder Trino-Datenbanken ist möglicherweise eine zusätzliche Datenbankkonfiguration erforderlich. Wenn SSL aktiviert ist, wird die PrestoDB- oder Trino-Datenbank standardmäßig auf Port 443 überwacht. Damit der SSH-Tunnel eingerichtet werden kann, muss Looker den Localhost-Port auf 443 festlegen. Dieser Port wird jedoch bereits von Looker verwendet. Dadurch schlägt die Einrichtung des SSH-Tunnels fehl. Um das Problem zu beheben, konfigurieren Sie Ihre PrestoDB- oder Trino-Datenbank so, dass sie bei aktivierter SSL einen anderen Port als Port 443 überwacht.

Auf dem Tab SSH-Server werden die von Ihnen hinzugefügten SSH-Serverkonfigurationen aufgeführt. Außerdem wird der Status der Verbindungen zu den SSH-Servern angezeigt und die Datenbankverbindungen, die die einzelnen SSH-Server verwenden, werden aufgeführt. Auf dem Tab SSH-Server können Sie auch eine Verbindung zu einem SSH-Server testen und SSH-Serverkonfigurationen hinzufügen oder bearbeiten.

In der folgenden Tabelle werden die Elemente auf dem Tab SSH-Server beschrieben:

Spalte Beschreibung
Servername Der Name der von Ihnen ausgewählten SSH-Serverkonfiguration, die zum Herstellen einer Verbindung zu Ihrer Datenbank verwendet wird.
Verbindungen Eine Liste der Datenbankverbindungen, die eine Verbindung zum SSH-Server herstellen. Wenn Sie auf eine Datenbankverbindung klicken, wird die Seite Verbindung bearbeiten für diese Datenbankverbindung geöffnet.
Dreipunkt-Menü Optionen  Folgende Aktionen sind für eine SSH-Serverkonfiguration möglich: Verbindungen zu einem SSH-Server testen, eine Datenbankverbindung zu einem SSH-Server hinzufügen, eine SSH-Serverkonfiguration bearbeiten oder eine SSH-Serverkonfiguration löschen.

SSH-Serverkonfiguration hinzufügen oder bearbeiten

So fügen Sie eine neue SSH-Serverkonfiguration hinzu:

  1. Klicken Sie auf dem Tab SSH Server (SSH-Server) auf Add Server (Server hinzufügen).
  2. Geben Sie oben rechts im Feld Unnamed Server (Unbenannter Server) einen Namen für die SSH-Serverkonfiguration ein.
  3. Klicken Sie auf Schlüssel herunterladen, um den öffentlichen Schlüssel in eine Textdatei herunterzuladen. Speichern Sie diese Datei zur späteren Verwendung.
  4. Geben Sie im Feld Servernutzername den Nutzernamen ein, den Looker zum Herstellen einer Verbindung mit dem SSH-Server verwendet.
  5. Geben Sie im Feld Server-IP‑Adresse oder Hostname die IP‑Adresse oder den Hostnamen des SSH‑Servers ein.
  6. Geben Sie im Feld Serverport die Portnummer ein, die für die Verbindung mit dem SSH-Server verwendet wird.
  7. Fügen Sie den heruntergeladenen öffentlichen Schlüssel der Datei mit autorisierten Schlüsseln auf Ihrem SSH-Server hinzu. Weitere Informationen und ein Beispiel finden Sie auf der Dokumentationsseite SSH-Server verwenden.
  8. Achten Sie darauf, dass die entsprechenden Looker-IP-Adressen der Allowlist auf Ihrem SSH-Server hinzugefügt werden, damit Looker eine Verbindung zum SSH-Server herstellen kann.
  9. Klicken Sie auf Testen und Fingerabdruck anfordern, um die Verbindung zum SSH-Server zu überprüfen.
  10. Rufen Sie die neue SSH-Konfiguration auf. Auf diesem Bildschirm können Sie auch den öffentlichen Schlüssel herunterladen oder ansehen und den eindeutigen Fingerabdruck der SSH-Serverkonfiguration aufrufen.

Wenn Sie eine vorhandene SSH-Serverkonfiguration bearbeiten möchten, klicken Sie in der Zeile des ausgewählten SSH-Servers auf das Dreipunkt-Menü Optionen und wählen Sie Serverdetails aus.

Verbindungen zu einem SSH-Server testen

So testen Sie alle Datenbankverbindungen zu einem SSH-Server:

  1. Klicken Sie in der Zeile des ausgewählten SSH-Servers auf das Dreipunkt-Menü Optionen.
  2. Wählen Sie Verbindungen testen aus.

Looker testet alle Datenbankverbindungen über diesen SSH-Server und zeigt neben dem Servernamen und allen Verbindungen, bei denen der Verbindungstest erfolgreich ist, ein grünes Häkchen an. Ein rotes Ausrufezeichen bedeutet, dass die Verbindung den Test nicht bestanden hat.

Datenbankverbindung zu einem SSH-Server hinzufügen

So fügen Sie eine neue Datenbankverbindung über einen SSH-Server hinzu:

  1. Klicken Sie in der Zeile des ausgewählten SSH-Servers auf das Dreipunkt-Menü Optionen.
  2. Wählen Sie Verbindung hinzufügen aus.

Looker zeigt die Seite Verbindungseinstellungen an. Der SSH-Server ist im Feld SSH-Server aufgeführt.

SSH-Serverkonfiguration löschen

So löschen Sie eine SSH-Serverkonfiguration:

  1. Klicken Sie in der Zeile des zu löschenden SSH-Servers auf das Dreipunkt-Menü Optionen.
  2. Wählen Sie Server löschen aus.

Verbindungen testen

Mit Looker können Sie Ihre vorhandenen Verbindungen testen, um sicherzustellen, dass sie ordnungsgemäß funktionieren. Sie können Verbindungen auch beim Hinzufügen testen, wie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden beschrieben.

Jeder Verbindungstest enthält eine Liste von Statusprüfungen, mit denen Sie feststellen können, ob Looker die Datenbankverbindung erfolgreich verwenden kann.

Potenzielle Probleme werden gelb und Fehler rot angezeigt. Wenn eine Verbindung „bestanden“ hat, wird sie grün dargestellt.

Für Datenbankverbindungen, die OAuth verwenden, z. B. Snowflake und Google BigQuery, ist eine Nutzeranmeldung erforderlich. Wenn Sie nicht bei Ihrem OAuth-Benutzerkonto angemeldet sind, wenn Sie eine dieser Verbindungen testen, zeigt Looker eine Warnung und den Link Anmelden an. Klicken Sie auf den Link, um Ihre OAuth-Anmeldedaten einzugeben oder Looker den Zugriff auf Ihre OAuth-Kontoinformationen zu gestatten.

Sie können den Status von Folgendem prüfen:

  • Eine einzelne Verbindung, indem Sie ganz rechts neben der Verbindung auf Test klicken
  • Alle Verbindungen testen, indem Sie oben auf der Seite auf die Schaltfläche Alle Verbindungen testen klicken

Zwei Prüfungen führen häufig zu Verwirrung:

  • Temporäres Schema kann gefunden werden
  • Persistente abgeleitete Tabellen verwenden

Diese Prüfungen müssen nicht bestanden werden, damit Looker funktioniert. Sie sind jedoch erforderlich, um dauerhafte abgeleitete Tabellen zu verwenden, die eine sehr nützliche Modellierungsfunktion sind.

Verbindungen hinzufügen

Wenn Sie eine neue Datenbankverbindung hinzufügen möchten, folgen Sie der Anleitung auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.

Verbindungen bearbeiten

Wenn Sie eine vorhandene Verbindung bearbeiten möchten, öffnen Sie die Seite Verbindungen. Wählen Sie dazu das Menü Administrator und dann unter Datenbank die Option Verbindungen aus. Klicken Sie für die Verbindung auf die Schaltfläche Bearbeiten. Die Seite, die Sie zum Erstellen einer Verbindung verwenden, wird angezeigt (wie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden beschrieben), aber die relevanten Informationen sind bereits ausgefüllt. Nehmen Sie die erforderlichen Änderungen vor und klicken Sie dann auf Verbindung aktualisieren.

Für alle Verbindungen verfügbare Aktionen

Alle Verbindungen bieten diese Optionen über das Zahnrad-Drop-down-Menü ganz rechts neben jeder Verbindung:

Option Beschreibung
SQL-Runner Mit dieser Option gelangen Sie zum SQL-Runner von Looker. Die richtige Verbindung und das richtige Schema sind bereits ausgewählt.
Entdecken Mit dieser Option gelangen Sie zu einer Liste mit grundlegenden, automatisch generierten Explore-Optionen für Ihre Verbindung. Diese basieren nicht auf Ihren benutzerdefinierten Datenmodellen, ermöglichen aber eine schnelle Berichterstellung für die Rohdaten in den Tabellen Ihrer Verbindung. Das ist in der Regel nur nützlich, um sich vor der Modellierung einen Überblick über den Tabelleninhalt zu verschaffen, nicht für die eigentliche Datenanalyse.
Löschen Wenn Sie eine bestehende Verbindung löschen möchten, klicken Sie ganz rechts neben einer Verbindung auf das Zahnrad-Drop-down-Menü und wählen Sie Löschen aus. Sie haben die Möglichkeit, das Löschen zu bestätigen. Wenn Sie dies tun, kann es nicht mehr rückgängig gemacht werden. Wenn Sie eine Verbindung versehentlich löschen, werden alle Abfragen deaktiviert, die sie verwenden. Wenn Sie jedoch eine neue Verbindung mit demselben Namen erstellen, wird die Funktionalität wiederhergestellt.

Für einige Verbindungen verfügbare Aktionen

Je nach Verbindungsdialekt sind im Drop-down-Menü mit dem Zahnrad rechts neben der Verbindung möglicherweise die folgenden zusätzlichen Optionen verfügbar:

Option Beschreibung
Tabellen anzeigen Mit dieser Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Explore-Abfragen basierend auf den Metadaten Ihrer Verbindung erstellen können. Obwohl diese Option mit dem ausgewählten Schemanamen, Tabellennamen und der Spaltenanzahl beginnt, können Sie sie wie jedes andere Looker-Explore bearbeiten.
Datenbanken anzeigen Mit dieser Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Explore-Abfragen basierend auf den Metadaten Ihrer Verbindung erstellen können. Obwohl diese Option mit dem ausgewählten Schemanamen, Katalognamen, der Anzahl der Tabellen und der Anzahl der Spalten beginnt, können Sie sie wie jeden anderen Looker-Explore bearbeiten.
Prozesse anzeigen Mit dieser Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Explore-Abfragen basierend auf den Prozessen erstellen können, die für diese Verbindung ausgeführt werden. Sie können auch den Status, die Dauer der Ausführung und andere Informationen abrufen. Das kann hilfreich sein, um die Ursache zu ermitteln, wenn Looker langsam ausgeführt wird oder eine Abfrage überhaupt nicht ausgeführt wird.
PAT-Ereignislog anzeigen Mit dieser Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Explore-Abfragen basierend auf der Aktivität der abgeleiteten Tabelle für diese Verbindung erstellen können. Die verfügbaren Felder werden auf der Dokumentationsseite Persistent abgeleitete Tabellen ausführlicher beschrieben.