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 sehen Sie Ihre Datenbankverbindungen und die IP-Adressen, die für den Netzwerkverkehr erforderlich sind. Wenn für Ihre Instanz die Möglichkeit zum Erstellen einer neuen Datenbank 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 Ihnen erstellten von Looker verwalteten Verbindungen angezeigt, sofern die Möglichkeit zum Erstellen einer neuen Datenbank für Ihre Instanz aktiviert wurde. Auf dem Tab Datenbanken können Sie den Status dieser Verbindungen testen und ihre Konfiguration bearbeiten.

Klicken Sie auf Öffentliche IP-Adressen, um eine Liste der IP-Adressen aufzurufen, die für den Netzwerkverkehr von Ihrer Looker-Instanz erforderlich sind. Je nach Region, in der Ihre Looker-Instanz gehostet wird, stammt der gesamte Netzwerktraffic von Looker 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 des Tabs Datenbanken beschrieben:

Spalte Beschreibung
Name Der von Ihnen ausgewählte Name der Verbindung, der im LookML-Parameter connection verwendet wird. Wenn Sie die Verbindung testen, wird in Looker unter dem Verbindungsnamen eine Liste der Statusprüfungen angezeigt.
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, mit der ein SSH-Tunnel zu Ihrer Datenbank erstellt wurde. Diese Spalte wird nur angezeigt, wenn der Tab SSH-Server in Ihrer Looker-Instanz aktiviert ist.
SSL Unabhängig davon, ob Sie zum Schutz der Daten, die zwischen Looker und Ihrer Datenbank übertragen werden, SSL-Verschlüsselung verwenden. Neben SSL gibt es weitere sichere Optionen.
Typ Der SQL-Dialekt der Datenbankverbindung.
Aktionen Mögliche Aktionen für eine Verbindung: Verbindung testen, Verbindung bearbeiten, andere Informationen zu einer Verbindung ansehen, zu einer Liste mit Links zu den Explores der Verbindung wechseln oder eine Verbindung löschen. Wenn für Ihre Instanz die Möglichkeit zum Erstellen einer neuen Datenbank aktiviert wurde, können Sie allen von Looker verwalteten Verbindungen auch Daten aus einer zusätzlichen Datenquelle hinzufügen.

Tab "SSH-Server"

Die Option SSH-Server ist verfügbar, wenn die Instanz in einer Kubernetes-Infrastruktur bereitgestellt wird und wenn die Möglichkeit zum Hinzufügen von Konfigurationsinformationen zum SSH-Server zu Ihrer Looker-Instanz aktiviert wurde. 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 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 setzen, der bereits von Looker verwendet wird. Dies führt dazu, dass die Einrichtung des SSH-Tunnels fehlschlägt. Um das Problem zu beheben, konfigurieren Sie Ihre PrestoDB- oder Trino-Datenbank so, dass sie bei aktiviertem SSL einen anderen Port als Port 443 überwacht.

Auf dem Tab SSH-Server sind die von Ihnen hinzugefügten SSH-Serverkonfigurationen aufgeführt. Außerdem sehen Sie den Status der Verbindungen zu den SSH-Servern und die Datenbankverbindungen, die über die einzelnen SSH-Server hergestellt werden. 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 ausgewählte Name der SSH-Serverkonfiguration, die für die 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  Mögliche Aktionen für eine SSH-Serverkonfiguration: Testen Sie Verbindungen zu einem SSH-Server, fügen Sie einem SSH-Server eine Datenbankverbindung hinzu, bearbeiten Sie eine SSH-Serverkonfiguration oder löschen Sie eine SSH-Serverkonfiguration.

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 rechts oben im Feld 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 für später.
  4. Geben Sie im Feld Server-Nutzername den Nutzernamen ein, den Looker zur Verbindungsherstellung 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 den 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 zur Zulassungsliste hinzugefügt wurden, damit Looker eine Verbindung zum SSH-Server herstellen kann.
  9. Klicken Sie auf Fingerabdruck testen und anfordern, um die Verbindung zum SSH-Server zu prüfen.
  10. Sehen Sie sich die neue SSH-Konfiguration an. Auf diesem Bildschirm können Sie auch den öffentlichen Schlüssel herunterladen oder ansehen und den eindeutigen Fingerabdruck der SSH-Serverkonfiguration aufrufen.

Klicken Sie zum Bearbeiten einer vorhandenen SSH-Serverkonfiguration in der Zeile des ausgewählten SSH-Servers auf das Dreipunkt-Menü Options (Optionen) und wählen Sie Server Details (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 Test Connections (Verbindungen testen) aus.

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

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ü Options (Optionen).
  2. Wählen Sie Add Connection (Verbindung hinzufügen) aus.

In Looker wird die Seite Verbindungseinstellungen angezeigt. 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ü Options (Optionen).
  2. Wählen Sie Server löschen aus.

Verbindungen testen

In 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, anhand derer Sie feststellen können, ob Looker die Datenbankverbindung erfolgreich verwenden kann.

Mögliche Probleme werden gelb dargestellt. werden rot angezeigt. Wenn eine Verbindung „bestanden“ ist, wird sie grün angezeigt.

Für Datenbankverbindungen, die OAuth verwenden, wie 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 folgender Elemente prüfen:

  • Für eine einzelne Verbindung, indem Sie ganz rechts neben dieser Verbindung auf Test klicken
  • Alle Verbindungen, indem Sie oben auf der Seite auf die Schaltfläche Test All Connections (Alle Verbindungen testen) klicken

Zwei Prüfungen sind häufige Ursachen 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 müssen jedoch übergeben werden, wenn persistente abgeleitete Tabellen verwendet werden sollen. Dabei handelt es sich um eine sehr wertvolle Modellierungsfunktion.

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. Klicken Sie dazu auf das Menü Verwaltung und wählen Sie dann unter Datenbank die Option Verbindungen aus. Klicken Sie auf die Schaltfläche Bearbeiten für die Verbindung. Es wird dieselbe Seite angezeigt, auf der Sie eine Verbindung erstellen (siehe die Dokumentationsseite Looker mit Ihrer Datenbank verbinden), die relevanten Informationen sind jedoch bereits ausgefüllt. Nehmen Sie die erforderlichen Änderungen vor und klicken Sie dann auf Verbindung aktualisieren.

Aktionen für alle Verbindungen verfügbar

Für alle Verbindungen sind diese Optionen im Drop-down-Menü mit dem Zahnrad ganz rechts verfügbar:

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 Über diese 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 jedoch schnelle Berichte zu den Rohdaten in den Tabellen Ihrer Verbindung. Dies ist in der Regel nur nützlich, um sich vor der Modellierung ein Bild vom Tabelleninhalt zu machen, nicht für die eigentliche Datenanalyse.
Löschen Wenn Sie eine vorhandene Verbindung löschen möchten, klicken Sie rechts neben der Verbindung auf das Drop-down-Menü mit dem Zahnradsymbol und wählen Sie Löschen aus. Sie können das Löschen bestätigen. Danach kann es nicht mehr rückgängig gemacht werden. Durch das versehentliche Löschen einer Verbindung werden alle Abfragen deaktiviert, die sie verwenden. Wenn Sie jedoch eine neue Verbindung mit demselben Namen erstellen, wird die Funktion wiederhergestellt.

Für einige Verbindungen verfügbare Aktionen

Je nach Verbindungsdialekt enthält das Zahnrad-Dropdown-Menü rechts neben der Verbindung möglicherweise die folgenden zusätzlichen Optionen:

Option Beschreibung
Tabellen anzeigen Über diese Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Explore-Abfragen basierend auf den Metadaten Ihrer Verbindung erstellen können. Diese Option beginnt zwar mit dem ausgewählten Schemanamen, Tabellennamen und der Spaltenanzahl, Sie können sie aber wie jedes andere Looker-Explore bearbeiten.
Datenbanken anzeigen Über diese Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Explore-Abfragen basierend auf den Metadaten Ihrer Verbindung erstellen können. Diese Option beginnt zwar mit dem Schemanamen, dem Katalognamen, der Tabellenanzahl und der Spaltenanzahl, die ausgewählt wurden, Sie können sie aber wie jedes andere Looker-Explore bearbeiten.
Prozesse anzeigen Über diese Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Explore-Abfragen basierend auf den über diese Verbindung ausgeführten Prozessen, ihrem Status, ihrer Laufzeit und anderen Informationen erstellen können. Dies kann hilfreich sein, um die Ursache zu ermitteln, wenn Looker langsam läuft 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 den Aktivitäten der abgeleiteten Tabelle für diese Verbindung erstellen können. Die verfügbaren Felder werden auf der Dokumentationsseite Persistent abgeleitete Tabellen ausführlicher beschrieben.