Koppelen aan PostgreSQL

PostgreSQL is een open source-beheersysteem voor relationele databases dat is ontwikkeld door een wereldwijd team van vrijwilligers.

De PostgreSQL-connector biedt u toegang tot gegevens in PostgreSQL-gebaseerde databases binnen Looker Studio.

In dit artikel:

• Koppelen aan PostgreSQL
• Opmerkingen
• Limieten
• Gerelateerde bronnen

Koppelen aan PostgreSQL

Deze connector gebruikt het JDBC-stuurprogramma van PostgreSQL om een gegevensbron van Looker Studio te koppelen aan een enkele PostgreSQL-databasetabel.

Ondersteunde versies

We hebben Looker Studio getest in de volgende versies van PostgreSQL:

• 9.6
• 10
• 11
• 12
• 13
• 14

Als u problemen ondervindt met een ondersteunde versie, kunt u ons dit laten weten via de Help-community van Looker Studio. U kunt hier functieverzoeken toevoegen en erop stemmen.

Koppelen

1. Log in bij Looker Studio.
2. Klik linksboven op de homepage van Looker Studio op Maken en selecteer Gegevensbron.
3. Selecteer de PostgreSQL-connector.
4. Stel de toegang in tot uw database met een van de koppelingsopties (zie hieronder).
5. Klik op VERIFIËREN.
   • U krijgt een lijst van tabellen in die database te zien.
6. Selecteer een tabel.
7. Klik op VERBINDEN.

U heeft nu toegang tot alle kolommen in de tabel als velden in uw rapporten.

Koppelingsopties

BASIS

Als u verbinding wilt maken met een hostnaam of IP-adres, moet u de volgende informatie opgeven:

• Hostnaam of IP-adres
• Poort (optioneel)
• Database
• Gebruikersnaam
• Wachtwoord

JDBC-URL

Als u een koppeling wilt maken via een JDBC-URL, geeft u de volgende koppelingsinformatie op:

• JDBC-URL
  Voorbeeld

  
  jdbc:postgresql://<hostnaam of IP-adres>[:<poort>]/<database>
  • Gebruikersnaam
  • Wachtwoord

Als u een JDBC-hostnaam gebruikt, kunt u ervoor zorgen dat deze toegankelijk is voor openbare tools voor DNS-lookup zoals Whois.

SSL aanzetten (optioneel)

Looker Studio ondersteunt veilige (versleutelde) verbindingen met de server met behulp van het Transport Layer Security-protocol (TLS). TLS wordt ook wel SSL (Secure Sockets Layer) genoemd. Als u een beveiligde verbinding wilt aanzetten, vinkt u SSL aanzetten aan en levert u uw SSL-configuratiebestanden aan.

Clientverificatie aanzetten (optioneel)

Als dit selectievakje is aangevinkt, kunt u een client-privésleutel en een clientcertificaat uploaden als dat vereist is voor toegang tot uw database.

Opmerking: Looker Studio verwacht een PKCS-8-clientsleutelindeling.

Meer informatie over beveiligde PostgreSQL-verbindingen.

Aangepaste query

Selecteer de optie AANGEPASTE QUERY om een SQL-query in te voeren in plaats van een koppeling te maken met één tabel. Looker Studio gebruikt deze aangepaste SQL als een 'inner select'-instructie voor elke gemaakte query voor de database.

Aangepaste SQL-query's mogen slechts één instructie hebben.

De onderstaande query werkt bijvoorbeeld niet omdat die meerdere SQL-instructies heeft:

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;

Dat geldt ook als u vanuit BigQuery verkent: uw set queryresultaten kan maar op één instructie zijn gebaseerd.

Opmerking: Er kan na 3 tot 5 minuten een time-out optreden voor query's in Looker Studio. Als er een time-out optreedt voor uw aangepaste query's, gebruikt u deze manieren om het probleem op te lossen:

• Vereenvoudig de query zodat de uitvoering sneller verloopt.
• Voer de query uit in uw database en sla de resultaten op in een aparte tabel. Maak dan verbinding met die tabel in uw gegevensbron.

Opmerkingen

Ondersteunde gegevenstypen

De PostgreSQL-connector ondersteunt momenteel de volgende gegevenstypen:

• Numeriek
• Teken
• Booleaans
• Datum/tijd (behalve Intervallen)

Wanneer Looker Studio een kolom van een niet-ondersteund type tegenkomt, wordt voor die kolom geen veld gemaakt.

Meer informatie over PostgreSQL-gegevenstypen.

Firewall- en databasetoegang

Als u Looker Studio toestemming wilt geven om verbinding te maken met en te zoeken naar databases achter een firewall, geeft u toegang tot specifieke IP-adressen. Misschien moet u ook instellen dat uw database verkeer van deze adressen accepteert. Raadpleeg de documentatie van uw specifieke database voor instructies.

Let op: De IP-adressen die Looker Studio op dit moment gebruikt om verbinding te maken met uw databases, worden begin 2023 gewijzigd. Open de onderstaande IP-adressen om ervoor te zorgen dat uw rapporten na de wijziging correct blijven werken.

De lijst met IP-adressen bekijken

142.251.74.0/23 
2001:4860:4807::/48 (optioneel, voor platforms die IPv6 ondersteunen)
74.125.0.0/16

Opmerking voor Cloud SQL PostgreSQL-instanties: De PostgreSQL-connector gebruikt de Cloud SQL-proxy niet als u verbinding maakt met Cloud SQL PostgreSQL-instanties. Als u verbinding maakt met een Cloud SQL PostgreSQL-instantie, voegt u de vermelde IP-adressen toe aan de lijst van gemachtigde netwerken. Bekijk de Cloud SQL-documentatie.

Limieten van de PostgreSQL-connector

• U kunt geen tabel selecteren buiten het openbare schema. U kunt de optie AANGEPASTE QUERY selecteren om een query te schrijven die tabellen in elk schema bevat.  

• Met deze connector kunt u query's uitvoeren voor maximaal 150.000 rijen per query. Als u deze limiet overschrijdt, worden de gegevens afgekapt.
• Kolomkoppen (veldnamen) mogen alleen ASCII-tekens bevatten. Niet-ASCII-tekens worden niet ondersteund.

Gerelateerde bronnen

Een gegevensbron maken