Administratoreinstellungen – Verbindungen

Öffnen Sie das Menü Verwaltung und wählen Sie unter Datenbank die Option Verbindungen aus, um die Seite Verbindungen aufzurufen.

Verbindungen ansehen

Auf der Seite Verbindungen sehen Sie Ihre Datenbankverbindungen und die IP-Adressen, die für den Netzwerkverkehr erforderlich sind. Wenn die Möglichkeit zum Erstellen einer neuen Datenbank für Ihre Instanz aktiviert ist, 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. 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 unter dem Verbindungsnamen eine Liste der Statusprüfungen angezeigt.
Datenbank Der Name der Datenbank, die von Looker bei Verwendung dieser Verbindung abgefragt wird.
Umfang 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, 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 Ob Sie die SSL-Verschlüsselung zum Schutz der Daten zwischen Looker und Ihrer Datenbank verwenden. Neben SSL gibt es noch andere sichere Optionen.
Typ Der SQL-Dialekt der Datenbankverbindung.
Aktionen Sie können Verbindungen testen, bearbeiten, weitere Informationen dazu aufrufen, eine Liste mit Links zu den Explores der Verbindung aufrufen oder eine Verbindung löschen. Wenn die Möglichkeit zum Erstellen einer neuen Datenbank für Ihre Instanz aktiviert ist, können Sie allen von Looker verwalteten Verbindungen auch Daten aus einer zusätzlichen Datenquelle 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 erstellen Sie einen 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 herzustellen, muss Looker den Localhost-Port auf 443 setzen, der bereits von Looker verwendet wird. Dies führt zum Fehlschlagen der SSH-Tunneleinrichtung. 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  Sie können folgende Aktionen für eine SSH-Serverkonfiguration ausführen: 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 auf Server hinzufügen.
  2. Geben Sie rechts oben im Feld Unnamed Server (Namenloser 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 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 Zulassungsliste auf Ihrem SSH-Server hinzugefügt werden, 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. Rufen Sie die neue SSH-Konfiguration auf. Auf diesem Bildschirm können Sie auch den öffentlichen Schlüssel herunterladen oder anzeigen 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 bestanden wurde, ein grünes Häkchen an. Ein rotes Ausrufezeichen bedeutet, dass der 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ü Optionen.
  2. Wählen Sie 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ü 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 Seite Looker mit Ihrer Datenbank verbinden beschrieben.

Jeder Verbindungstest enthält eine Liste von Statusprüfungen, die Aufschluss darüber geben, ob Looker die Datenbankverbindung erfolgreich verwenden kann.

Potenzielle Probleme werden gelb und Fehler rot angezeigt. Wenn eine Verbindung besteht, 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:

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

Zwei Prüfungen sind häufige Ursachen für Verwirrung:

  • Temporäres Schema kann gefunden werden
  • Sie können persistente abgeleitete Tabellen verwenden.

Diese Prüfungen müssen nicht bestanden werden, damit Looker funktioniert. Sie müssen jedoch bestanden werden, um persistente 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. 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, die Sie zum Erstellen einer Verbindung verwenden (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.
Erkunden Über diese Option gelangen Sie zu einer Liste mit grundlegenden, automatisch generierten Explore-Optionen für Ihre Verbindung. Sie basieren nicht auf Ihren benutzerdefinierten Datenmodellen, ermöglichen aber 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, und 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. Wenn Sie versehentlich eine Verbindung löschen, 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 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 Ü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 Persistente abgeleitete Tabellen ausführlicher beschrieben.