Mit PostgreSQL verbinden

Sie können Ihre PostgreSQL-Datenbanken mit Data Studio verbinden, um Ihre Daten zu visualisieren und zu analysieren. Mit dem PostgreSQL-Connector können Sie Ihre Daten in interaktive Dashboards und Berichte umwandeln. Anschließend können Sie die Erkenntnisse mit Ihrem Team oder Stakeholdern teilen, die keinen direkten Datenbankzugriff haben.

Unterstützte Versionen

Wir haben Data Studio mit den folgenden PostgreSQL-Versionen getestet:

  • 9,6
  • 10
  • 11
  • 12
  • 13
  • 14

Sollten Probleme mit einer unterstützten Version auftreten, teilen Sie uns dies bitte über die Data Studio-Community mit. Auf dieser Seite können Sie Feature Requests stellen und darüber abstimmen.

Verbindung zu PostgreSQL herstellen

Der PostgreSQL-Connector verwendet den PostgreSQL JDBC-Treiber, um eine Data Studio-Datenquelle mit einer einzelnen PostgreSQL-Datenbanktabelle oder einer von Ihnen angegebenen benutzerdefinierten Abfrage zu verbinden.

So stellen Sie eine Verbindung zu Ihrer PostgreSQL-Datenbank her:

  1. Melden Sie sich in Data Studio an.
  2. Klicken Sie auf der Data Studio-Startseite auf  Erstellen und wählen Sie dann Datenquelle aus.
  3. Wählen Sie den PostgreSQL-Connector aus.
  4. Autorisieren Sie gegebenenfalls Data Studio, auf Ihre Daten zuzugreifen.
  5. Konfigurieren Sie den Zugriff auf Ihre Datenbank mit einer der Verbindungsoptionen.
  6. Klicken Sie auf AUTHENTIFIZIEREN. Eine Liste der Tabellen in dieser Datenbank wird angezeigt.
  7. Wählen Sie eine Tabelle aus der Liste aus oder geben Sie eine benutzerdefinierte Abfrage ein.
  8. Klicken Sie auf Verbinden.

Sie können jetzt in Ihren Berichten auf alle Spalten in der Tabelle als Felder zugreifen.

Verbindungsoptionen

Verbindung über einen Hostnamen oder eine IP-Adresse herstellen

Wählen Sie im Verbindungsbereich BASIC aus. Geben Sie die Verbindungsdetails ein:

  • Hostname oder IP-Adresse
  • Port (optional)
  • Datenbank
  • Nutzername
  • Passwort

Verbindung über eine JDBC-URL herstellen

Wählen Sie im Verbindungsbereich JDBC-URL aus. Geben Sie die Verbindungsdetails ein:

  • JDBC-URL

    • Beispiel jdbc:postgresql://HOSTNAME[:PORT]/DATABASE

    • Für Cloud SQL (Private IP-Adresse) jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE

  • Nutzername
  • Passwort

Wenn Sie eine Verbindung über eine literale IPv6-Adresse herstellen möchten, setzen Sie die Adresse in eckige Klammern. Beispiel: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

Verbindung über SSL herstellen

Data Studio unterstützt sichere (verschlüsselte) Verbindungen zum Server über das TLS-Protokoll (Transport Layer Security) (TLS 1.2). TLS wird auch als SSL (Secure Sockets Layer) bezeichnet.

Wenn Sie eine sichere Verbindung herstellen möchten, wählen Sie SSL aktivieren aus und geben Sie die SSL-Konfigurationsdateien an.

Verbindung über die Clientauthentifizierung herstellen

Wenn das Kästchen Clientauthentifizierung aktivieren angeklickt ist, können Sie einen privaten Clientschlüssel und ein Clientzertifikat für den Zugriff auf Ihre Datenbank hochladen.

Weitere Informationen zu sicheren PostgreSQL-Verbindungen

Benutzerdefinierte Abfrage

Wählen Sie die Option BENUTZERDEFINIERTE ABFRAGE aus, um eine SQL-Abfrage anzugeben, anstatt eine Verbindung zu einer einzelnen Tabelle herzustellen. Ihre benutzerdefinierte SQL-Abfrage wird dabei als innere SELECT-Anweisung für jede generierte Datenbankabfrage verwendet.

Benutzerdefinierte SQL-Abfragen dürfen nicht mehr als eine Anweisung enthalten. Die folgende Abfrage würde z. B. nicht funktionieren, weil sie mehrere SQL-Anweisungen enthält:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

Bei Abfragen in Data Studio kann es nach drei bis fünf Minuten zu einer Zeitüberschreitung kommen. So können Sie diesem Problem entgegenwirken:

  • Vereinfachen Sie die Abfrage, damit sie schneller ausgeführt werden kann.
  • Führen Sie die Abfrage in Ihrer Datenbank aus und speichern Sie die Ergebnisse in einer separaten Tabelle. Verbinden Sie die neue Tabelle in Ihrer Datenquelle.

Unterstützte Datentypen

Der PostgreSQL-Connector unterstützt die folgenden Datentypen:

  • Numerisch
  • Zeichen
  • Boolesch
  • Datum/Uhrzeit (außer Intervalle)

Für Spalten eines nicht unterstützten Typs werden in Data Studio keine Felder erstellt.

Weitere Informationen zu PostgreSQL-Datentypen

Öffentliche und private Verbindungen

Data Studio unterstützt sowohl öffentliche als auch private IP-Verbindungen zu PostgreSQL in Cloud SQL.

Wenn Sie eine Verbindung über eine private IP-Adresse herstellen möchten, müssen Sie die Verbindungsoption JDBC-URL im Format jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE verwenden. Außerdem müssen Sie in den Einstellungen Ihrer Cloud SQL-Instanz die Option Privater Pfad für Google Cloud-Dienste auswählen.

Firewall- und Datenbankzugriff

Damit Data Studio eine Verbindung zu Datenbanken herstellen kann, die durch eine Firewall geschützt sind, und Abfragen an sie senden kann, müssen Sie den Zugriff auf eine der folgenden IP-Adressen öffnen. Möglicherweise müssen Sie Ihre Datenbank auch so konfigurieren, dass Zugriffe von diesen Adressen akzeptiert werden. Entsprechende Anleitungen finden Sie in der Dokumentation Ihrer Datenbank.

IP-Adressen

Die folgenden Adressen sind für die globale Infrastruktur von Data Studio reserviert:

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (optional für Plattformen, die IPv6 unterstützen)

Wenn Sie den Datenstandort für Ihr Data Studio Pro-Abo aktiviert haben, verwenden Sie stattdessen die folgenden Adressen:

  • 142.251.56.0/24

  • 2001:4860:4815::/48 (optional für Plattformen, die IPv6 unterstützen)

Beschränkungen des PostgreSQL-Connectors

  • Der PostgreSQL-Connector verwendet bei einer Verbindung zu PostgreSQL-Instanzen in Cloud SQL nicht den Cloud SQL-Proxy. Wenn Sie eine Cloud SQL PostgreSQL-Instanz über eine öffentliche IP-Adresse verbinden, müssen Sie die aufgeführten IP-Adressen der Liste der autorisierten Netzwerke hinzufügen. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation.

  • Verbindungen zu AlloyDB-Datenquellen über SSL werden nicht unterstützt, da in AlloyDB keine Zertifizierungsstellenzertifikate (Certificate Authority, CA) exportiert werden können.

  • Sie können außerhalb des public-Schemas keine Tabelle auswählen. Mit der Option BENUTZERDEFINIERTE ABFRAGE lässt sich jedoch eine Abfrage schreiben, die Tabellen in beliebigen Schemata enthält.

  • Mit diesem Connector können pro Vorgang bis zu 150.000 Zeilen abgefragt werden. Wird das Limit überschritten, werden die Daten abgeschnitten.

  • Spaltenüberschriften (Feldnamen) dürfen nur ASCII-Zeichen enthalten. Andere Zeichen werden nicht unterstützt.

Fehlerbehebung

In den Tipps zur Fehlerbehebung in der Data Studio-Hilfe finden Sie eine Liste häufiger Fehlermeldungen und Schritte zur Fehlerbehebung.

Datenquelle erstellen