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 Netzwerktraffic erforderlich sind. Wenn die Möglichkeit zum Erstellen einer neuen Datenbank für Ihre Instanz aktiviert wurde, können Sie auch eine neue Verbindung hinzufügen.

Tab „Datenbanken“

Der Tab Datenbanken enthält grundlegende Informationen zu den von Ihnen definierten Datenbankverbindungen. Außerdem werden alle von Looker verwalteten Verbindungen angezeigt, die Sie erstellt haben, wenn die Funktion zum Erstellen einer neuen Datenbank für Ihre Instanz aktiviert wurde. Auf dem Tab Datenbanken können Sie auch den Status dieser Verbindungen testen und die Konfiguration bearbeiten.

Sie können auf Öffentliche IP-Adressen klicken, um die Liste der IP-Adressen aufzurufen, die erforderlich sind, um Netzwerktraffic von Ihrer Looker-Instanz zuzulassen. Der gesamte Netzwerk-Traffic von Looker stammt basierend auf der Region, in der Ihre Looker-Instanz gehostet wird, von einer der aufgelisteten IP-Adressen. Sie können den Datenzugriff auf einfache Weise 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, zeigt Looker die Liste der Statusprüfungen unter dem Verbindungsnamen an.
Datenbank Der Name der Datenbank, die Looker bei dieser Verbindung abfragt.
Geltungsbereich Gibt an, ob die Verbindung für alle Projekte oder nur für ein bestimmtes 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 Unabhängig davon, ob Sie die zwischen Looker und Ihrer Datenbank übertragenen Daten mithilfe von SSL-Verschlüsselung schützen. Neben SSL gibt es weitere sichere Optionen.
Typ Der SQL-Dialekt der Datenbankverbindung.
Aktionen Mögliche Aktionen für eine Verbindung: Sie können eine Verbindung testen, bearbeiten, weitere Informationen zu einer Verbindung ansehen, zu einer Liste mit Links zu den Explores der Verbindung wechseln oder eine Verbindung löschen. Wenn die Funktion zum Erstellen einer neuen Datenbank für Ihre Instanz 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 nur verfügbar, wenn die Instanz in einer Kubernetes-Infrastruktur bereitgestellt wird und die Möglichkeit zum Hinzufügen von SSH-Serverkonfigurationsinformationen zu Ihrer Looker-Instanz aktiviert wurde. Wenn diese Option in Ihrer Looker-Instanz nicht aktiviert ist, Sie sie aber 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. Derzeit können Sie den Localhost-Port nicht angeben.

SSH-Verbindungen zu PrestoDB- oder Trino-Datenbanken erfordern möglicherweise eine zusätzliche Datenbankkonfiguration. Wenn SSL aktiviert ist, überwacht die PrestoDB- oder Trino-Datenbank standardmäßig Port 443. Zum Einrichten des SSH-Tunnels 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 einen anderen Port als Port 443 überwacht, wenn SSL aktiviert ist.

Auf dem Tab SSH-Server werden die hinzugefügten SSH-Serverkonfigurationen, der Status der Verbindungen zu den SSH-Servern und die Datenbankverbindungen über jeden SSH-Server aufgeführt. Auf dem Tab SSH-Server können Sie auch die Verbindung zu einem SSH-Server testen und SSH-Serverkonfigurationen hinzufügen oder bearbeiten.

In der folgenden Tabelle werden die Elemente des Tabs SSH-Server beschrieben:

Spalte Beschreibung
Servername Der Name der von Ihnen gewä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.
Optionsmenü Mögliche Aktionen für eine SSH-Serverkonfiguration: 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 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 als Textdatei herunterzuladen. Speichern Sie diese Datei zur späteren Verwendung.
  4. Geben Sie im Feld Server Username (Servernutzername) den Nutzernamen ein, mit dem Looker eine Verbindung zum SSH-Server herstellt.
  5. Geben Sie in das Feld Server-IP-Adresse oder Hostname die IP-Adresse oder den Hostnamen des SSH-Servers ein.
  6. Geben Sie im Feld Server Port (Serverport) die Portnummer ein, die für die Verbindung mit dem SSH-Server verwendet wird.
  7. Fügen Sie den heruntergeladenen öffentlichen Schlüssel zur autorisierten Schlüsseldatei 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 Zulassungsliste auf Ihrem SSH-Server hinzugefügt wurden, damit Looker eine Verbindung zum SSH-Server herstellen kann.
  9. Klicken Sie auf Test & Fingerabdruck anfordern, um Ihre Verbindung zum SSH-Server zu überprü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 sich den eindeutigen Fingerabdruck der SSH-Serverkonfiguration ansehen.

Wenn Sie eine bestehende SSH-Serverkonfiguration bearbeiten möchten, klicken Sie in der Zeile des gewünschten 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 auf das Dreipunkt-Menü in der Zeile des gewünschten SSH-Servers.
  2. Wählen Sie Test Connections (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 bestanden wurde. 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 mithilfe eines SSH-Servers hinzu:

  1. Klicken Sie auf das Dreipunkt-Menü in der Zeile des gewünschten SSH-Servers.
  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 auf das Dreipunkt-Menü in der Zeile des zu löschenden SSH-Servers.
  2. Wählen Sie Server löschen aus.

Verbindungen testen

Mit Looker können Sie Ihre bestehenden Verbindungen testen, um sicherzustellen, dass sie ordnungsgemäß funktionieren. Sie können Verbindungen auch testen, während Sie sie hinzufügen, 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.

Mögliche Probleme werden gelb und Fehler rot angezeigt. Wenn eine Verbindung erfolgreich ist, wird sie grün angezeigt.

Für Datenbankverbindungen mit OAuth wie Snowflake und Google BigQuery ist eine Nutzeranmeldung erforderlich. Wenn Sie beim Testen einer dieser Verbindungen nicht in Ihrem OAuth-Nutzerkonto angemeldet sind, zeigt Looker eine Warnung mit einem 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:

  • Eine einzelne Verbindung, indem Sie ganz rechts daneben auf Test klicken
  • Alle Verbindungen durch Klicken auf die Schaltfläche Test All Connections oben auf der Seite

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

  • Temporäres Schema kann gefunden werden
  • Kann persistente abgeleitete Tabellen verwenden

Diese Prüfungen müssen nicht bestanden werden, damit Looker funktioniert. Sie müssen jedoch übergeben werden, um nichtflüchtige 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 bestehende Verbindung bearbeiten möchten, klicken Sie ganz rechts neben der jeweiligen Verbindung auf die Schaltfläche Bearbeiten. Es wird die Seite angezeigt, auf der Sie eine Verbindung herstellen (eine Beschreibung in der Dokumentationsseite Looker mit Ihrer Datenbank verbinden), aber mit den relevanten Informationen bereits ausgefüllt. Nehmen Sie die erforderlichen Änderungen vor und klicken Sie dann auf Update Connection (Verbindung aktualisieren).

Für alle Verbindungen verfügbare Aktionen

Bei allen Verbindungen stehen über das Zahnrad-Dropdown-Menü ganz rechts neben den einzelnen Verbindungen folgende Optionen zur Verfügung:

Wahltaste 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 können Sie eine Liste mit grundlegenden, automatisch generierten Explore-Optionen für Ihre Verbindung aufrufen. Diese basieren nicht auf Ihren benutzerdefinierten Datenmodellen, ermöglichen jedoch eine schnelle Berichterstellung für die 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 den Zweck der eigentlichen 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 erhalten die Möglichkeit, den Löschvorgang zu bestätigen. Dieser Vorgang kann jedoch nicht rückgängig gemacht werden. Durch das versehentliche Löschen einer Verbindung werden alle Abfragen deaktiviert, in denen sie verwendet wird. 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 enthält das Zahnradsymbol rechts neben der Verbindung möglicherweise die folgenden zusätzlichen Optionen:

Wahltaste Beschreibung
Tabellen anzeigen Mit dieser Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Berichte basierend auf den Metadaten Ihrer Verbindung erstellen können. Obwohl diese Option mit dem Schemanamen, dem Tabellennamen und der ausgewählten Spaltenanzahl beginnt, können Sie sie wie jeden anderen Looker-Bericht bearbeiten.
Datenbanken anzeigen Mit dieser Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Berichte basierend auf den Metadaten Ihrer Verbindung erstellen können. Obwohl diese Option mit dem Schemanamen, dem Katalognamen, der Tabellenanzahl und der ausgewählten Spaltenanzahl beginnt, können Sie sie wie jeden anderen Looker-Bericht bearbeiten.
Prozesse anzeigen Mit dieser Option gelangen Sie zu einer Looker-Explore-Seite, auf der Sie Looker-Berichte basierend auf den Prozessen erstellen können, die über diese Verbindung ausgeführt werden, dem Status, in dem sie sich befinden, wie lange sie bereits ausgeführt werden, und anderen Informationen. Dies 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-Berichte 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 genauer beschrieben.