Administratoreinstellungen – Verbindungen

Um die Seite Verbindungen aufzurufen, öffnen Sie das Menü Admin 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 für den Netzwerkverkehr erforderlich sind. Wenn die Erstellung einer neuen Datenbank für Ihre Instanz aktiviert wurde, können Sie auch eine neue Verbindung hinzufügen.

Tab „Datenbanken“

Auf dem Tab Datenbanken finden Sie grundlegende Informationen zu den von Ihnen definierten Datenbankverbindungen. 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. Auf dem Tab Datenbanken können Sie auch den Status dieser Verbindungen testen und ihre 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.

Wenn Sie die Administratorrolle haben, können Sie oben auf der Looker-Seite Verbindungen auf die Schaltfläche Erreichbarkeit testen klicken, um zu prüfen, ob Looker einen Hostnamen und einen Port über das Netzwerk erreichen kann. Weitere Informationen finden Sie unter Diagnose der Netzwerkerreichbarkeit.

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, zeigt Looker die Liste der Statusprüfungen unter dem Verbindungsnamen an.
Datenbank Der Name der Datenbank, die Looker bei Verwendung dieser Verbindung abfragt.
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 auf Ihrer Looker-Instanz aktiviert ist.
SSL Ob Sie die 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 Aktionen, die Sie für eine Verbindung ausführen können: Verbindung testen, Verbindung bearbeiten, weitere Informationen zu einer Verbindung aufrufen, zu einer Liste mit 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 allen 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 Vertriebsspezialisten von Google Cloud oder stellen Sie eine Supportanfrage.

Looker wählt beim Erstellen von SSH-Tunneln automatisch den Localhost-Port für Sie aus. 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, überwacht die PrestoDB- oder Trino-Datenbank standardmäßig Port 443. Um den SSH-Tunnel einzurichten, muss Looker den Localhost-Port auf 443 festlegen, der bereits von Looker verwendet wird. Andernfalls schlägt die Einrichtung des SSH-Tunnels fehl. Konfigurieren Sie Ihre PrestoDB- oder Trino-Datenbank so, dass sie auf einen anderen Port als Port 443 lauscht, wenn SSL aktiviert ist.

Auf dem Tab SSH-Server werden die von Ihnen hinzugefügten SSH-Serverkonfigurationen aufgeführt, der Status der Verbindungen zu den SSH-Servern angezeigt und die Datenbankverbindungen aufgelistet, die die einzelnen SSH-Server verwenden. 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 von Ihnen gewählte Name der SSH-Serverkonfiguration, die für die Verbindung mit 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  Aktionen, die Sie für eine SSH-Serverkonfiguration ausführen können: Verbindungen zu einem SSH-Server testen, Datenbankverbindung zu einem SSH-Server hinzufügen, SSH-Serverkonfiguration bearbeiten oder 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 auf Server hinzufügen.
  2. Geben Sie im Feld Unnamed Server (Unbenannter Server) rechts oben 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 für die spätere Verwendung.
  4. Geben Sie im Feld Server Username 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 für die Verbindung mit dem SSH-Server ein.
  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 auf Ihrem SSH-Server auf die Zulassungsliste gesetzt 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 prü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, die diesen SSH-Server verwenden, und zeigt ein grünes Häkchen neben dem Servernamen und allen Verbindungen an, bei denen der Verbindungstest erfolgreich war. 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, auf der der SSH-Server im Feld SSH-Server aufgeführt ist.

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, die Ihnen mitteilen, ob Looker die Datenbankverbindung erfolgreich verwenden kann.

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

Sie können den Status folgender Elemente prüfen:

  • Eine einzelne Verbindung, indem Sie ganz rechts neben der Verbindung auf Testen klicken
  • Alle Verbindungen, indem Sie oben auf der Seite auf den Button Alle Verbindungen testen klicken

Zwei Prüfungen sorgen häufig für Verwirrung:

  • Kann temporäres Schema finden
  • Kann persistente abgeleitete Tabellen verwenden

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

Netzwerkdiagnose

Looker bietet zwei Tools, mit denen Sie herausfinden können, ob ein Verbindungsproblem durch das Netzwerk (z. B. eine Firewallregel oder eine fehlende Route) oder durch die Datenbank (z. B. falsche Anmeldedaten) verursacht wird:

Beide Tools suchen den Hostnamen im DNS und versuchen dann, eine TCP-Verbindung zu jeder IP-Adresse herzustellen, die die Suche zurückgibt. Da TCP-Verbindungen anstelle von ICMP-Ping-Anfragen verwendet werden, kann ein Host, der Ping-Anfragen blockiert, trotzdem als erreichbar angezeigt werden.

Netzwerkdiagnose in den Ergebnissen von Verbindungstests

Wenn ein Verbindungstest keine Verbindung zur Datenbank herstellen kann, testet Looker die folgenden Endpunkte und fügt die Ergebnisse am Ende der Fehlermeldung unter Network Diagnostics: hinzu:

  • Für alle Verbindungen: der Host und der Port, die für die Verbindung konfiguriert sind.
  • Bei Amazon Athena-Verbindungen der AWS Glue-Endpunkt für die AWS-Region der Verbindung über Port 443, z. B. glue.us-east-1.amazonaws.com.
  • Für Cloud SQL-Verbindungen, deren Feld Host einen Instanzverbindungsnamen wie my-project:us-central1:my-instance enthält, der Endpunkt sqladmin.googleapis.com auf Port 443. Der Cloud SQL-Connector verwendet diesen Endpunkt, um Instanzinformationen und Zertifikate abzurufen.

Looker testet bis zu drei IP-Adressen für jeden Endpunkt. Die Diagnose dauert maximal 3 Sekunden. Looker führt keine Netzwerkdiagnose für Verbindungen aus, die einen SSH-Tunnel verwenden.

Die folgenden Diagnosen zeigen beispielsweise, dass Looker den Athena-Endpunkt erreichen kann, aber bei Verbindungen zum AWS Glue-Endpunkt ein Zeitüberschreitungsfehler auftritt:

Network Diagnostics:
- athena.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.10 - success
- glue.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.20 - timeout (3000ms)
  - 203.0.113.21 - timeout (3000ms)

Für jede IP-Adresse wird eines der folgenden Ergebnisse angezeigt:

  • success: Looker hat eine TCP-Verbindung zur IP-Adresse und zum Port geöffnet. Wenn für jede IP-Adresse success angezeigt wird, der Test aber trotzdem fehlschlägt, prüfen Sie die Verbindungseinstellungen, z. B. die Anmeldedaten, die SSL-Einstellungen und die Nutzerberechtigungen des Datenbanknutzers.
  • timeout (3000ms): Looker hat innerhalb von 3 Sekunden keine Antwort erhalten. Dieses Ergebnis bedeutet oft, dass der Traffic durch eine Firewallregel, eine Sicherheitsgruppe oder eine fehlende Netzwerkroute verworfen wird.
  • failed: gefolgt von einem Grund: Die Verbindung wurde abgelehnt oder das Netzwerk war nicht erreichbar. Connection refused bedeutet beispielsweise, dass nichts am Port überwacht wird oder dass eine Firewall die Verbindung abgelehnt hat.
  • blocked (sensitive IP): Looker hat die IP-Adresse nicht getestet, da sie sich in einem eingeschränkten Bereich befindet.

Wenn die DNS-Suche fehlschlägt, wird für den Endpunkt DNS resolution failed: gefolgt vom Grund angezeigt. Überprüfen Sie den Hostnamen auf Tippfehler. Wenn die Datenbank einen privaten Hostnamen verwendet, muss Looker diesen auflösen können.

Network Reachability-Diagnose

Wenn Sie die Looker-Administratorrolle haben, können Sie einen Datenbankhost testen, bevor Sie eine Verbindung hinzufügen, oder einen Endpunkt testen, von dem eine Verbindung abhängt, z. B. sqladmin.googleapis.com auf Port 443.

So testen Sie die Netzwerk-Erreichbarkeit:

  1. Klicken Sie auf der Seite Verbindungen oben auf den Button Erreichbarkeit testen.
  2. Geben Sie im Dialogfeld Diagnose der Netzwerkerreichbarkeit im Feld Hostname oder Domain einen Hostnamen oder eine IP-Adresse ein.
  3. Geben Sie im Feld Port den zu testenden Port ein. Der Standardwert ist 443.
  4. Klicken Sie auf Testen.

Looker testet bis zu fünf IP-Adressen für den Hostnamen. Der Test dauert maximal 3 Sekunden. Hier ist ein Beispiel für ein Dialogfeld „Network Reachability-Diagnose“ mit Testergebnissen für einen Hostnamen und einen Port:

Das Dialogfeld „Network Reachability-Diagnose“ mit Testergebnissen für einen Hostnamen und einen Port.

Für jede IP-Adresse wird im Dialogfeld eine Meldung angezeigt, wie lange die Verbindung in Millisekunden gedauert hat, wenn sie erfolgreich war, und einer der folgenden Status:

  • Verbunden: Looker hat eine TCP-Verbindung zur IP-Adresse und zum Port geöffnet.
  • Zeitüberschreitung: Looker hat innerhalb von 3 Sekunden keine Antwort erhalten.
  • Fehlgeschlagen: Die Verbindung wurde abgelehnt oder das Netzwerk war nicht erreichbar. In der Meldung wird der Grund angegeben.
  • SSRF blockiert: Looker hat die IP-Adresse nicht getestet, da sie sich in einem eingeschränkten Bereich befindet. Diese Einschränkungen schützen vor serverseitiger Anfragefälschung (Server-Side Request Forgery, SSRF).

Wenn Looker den Hostnamen nicht auflösen kann oder der Port eingeschränkt ist, wird im Dialogfeld eine Fehlermeldung anstelle von Ergebnissen angezeigt.

Eingeschränkte Adressen und Ports

Zum Schutz Ihrer Instanz werden IP-Adressen in den folgenden Bereichen von der Looker-Netzwerkdiagnose nicht getestet:

  • Loopback-, Link-Local-, Multicast- und andere eingeschränkte Adressbereiche, einschließlich der Metadatenserveradresse 169.254.169.254.
  • Private Adressbereiche (10.0.0.0/8, 172.16.0.0/12 und 192.168.0.0/16) auf Looker (Google Cloud Core)-Instanzen, die nur öffentliche sichere Verbindungen verwenden.

Außerdem werden mit der Funktion Erreichbarkeit testen einige Ports, die aus Sicherheitsgründen eingeschränkt sind, nicht getestet, z. B. Port 22. Wenn Sie einen dieser Ports eingeben, wird im Dialogfeld eine Meldung wie Port 22 is restricted from diagnostic probing for security reasons angezeigt.

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, indem Sie das Menü Admin und dann unter Datenbank die Option Verbindungen auswählen. Klicken Sie für die Verbindung auf den Button Bearbeiten. Es wird dieselbe Seite angezeigt, die Sie zum Erstellen einer Verbindung verwenden (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 auf Verbindung aktualisieren.

Für alle Verbindungen verfügbare Aktionen

Für alle Verbindungen sind im Drop-down-Menü mit dem Zahnradsymbol ganz rechts neben der jeweiligen Verbindung die folgenden Optionen verfügbar:

Option Beschreibung
SQL-Runner Mit dieser Option gelangen Sie zum SQL-Runner von Looker, wobei die richtige Verbindung und das richtige Schema bereits ausgewählt sind.
Erkunden Mit dieser Option gelangen Sie zu einer Liste grundlegender, automatisch generierter Explore-Optionen für Ihre Verbindung. Diese basieren nicht auf Ihren benutzerdefinierten Datenmodellen, ermöglichen aber eine schnelle Berichterstellung zu den Rohdaten in den Tabellen Ihrer Verbindung. Dies ist in der Regel nur nützlich, um sich vor der Modellierung einen Überblick über den Tabelleninhalt zu verschaffen, und nicht für die eigentliche Datenanalyse.
Löschen Wenn Sie eine bestehende Verbindung löschen möchten, klicken Sie ganz rechts neben der Verbindung auf das Zahnradsymbol und wählen Sie Löschen aus. Sie werden aufgefordert, das Löschen zu bestätigen. Sobald Sie dies getan haben, kann der Vorgang nicht mehr rückgängig gemacht werden. Wenn Sie eine Verbindung versehentlich löschen, werden alle Abfragen deaktiviert, die diese Verbindung verwenden. Außerdem können LookML-Validierungsfehler für Entwickler auftreten. Wenn Sie jedoch eine neue Verbindung mit demselben Namen erstellen, wird die Funktionalität wiederhergestellt.

Aktionen für einige Verbindungen verfügbar

Je nach Verbindungsdialekt bietet das Zahnrad-Drop-down-Menü rechts neben der Verbindung möglicherweise die folgenden zusätzlichen Optionen:

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 Tabellenanzahl und der Spaltenanzahl 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, ihrem Status, ihrer Laufzeit und anderen Informationen. Das kann hilfreich sein, um die Ursache zu ermitteln, wenn Looker langsam ist oder eine Abfrage überhaupt nicht ausgeführt wird.
PAT-Ereignisprotokoll anzeigen Über diese 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 Persistente abgeleitete Tabellen ausführlicher beschrieben.

Datenbankverbindung sicher löschen

Wenn Sie eine Datenbankverbindung löschen, auf die noch von LookML-Modellen verwiesen wird, führt dies zu Validierungsfehlern, die Entwickler daran hindern können, Branches zu committen oder zusammenzuführen. So löschen Sie eine Verbindung sicher:

  1. Abhängigkeiten identifizieren: Verwenden Sie im Entwicklungsmodus die Projektsuche nach connection: CONNECTION_NAME, um alle LookML-Modelldateien zu finden, die auf die Verbindung verweisen.
  2. Abhängigkeiten entfernen: Aktualisieren Sie den Parameter connection in diesen Modelldateien, sodass er auf eine gültige Verbindung verweist, oder löschen Sie die abhängigen Modelle, wenn sie nicht mehr benötigt werden.
  3. Inhalte validieren: Führen Sie die Inhaltsvalidierung aus, um Looks oder Dashboards zu identifizieren und zu korrigieren, die auf den Modellen basieren, die die Verbindung verwenden.
  4. Änderungen bereitstellen: Führen Sie einen Commit für diese LookML-Änderungen durch und stellen Sie sie im Produktionszweig bereit.
  5. Verbindung löschen: Nachdem alle Verweise aus dem Produktionszweig entfernt wurden, rufen Sie Admin > Datenbank > Verbindungen auf und löschen Sie die Verbindung.