Se connecter à PostgreSQL

Vous pouvez connecter vos bases de données PostgreSQL à Data Studio pour visualiser et analyser vos données. Utilisez le connecteur PostgreSQL pour transformer vos données en tableaux de bord et rapports interactifs. Vous pouvez ensuite partager vos insights avec votre équipe ou les parties prenantes qui n'ont pas d'accès direct à la base de données.

Versions compatibles

Nous avons testé Data Studio sur les versions suivantes de PostgreSQL :

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

Si vous rencontrez des problèmes lors de l'utilisation d'une version compatible, veuillez nous en informer dans la communauté Data Studio. Vous pouvez également ajouter des demandes de fonctionnalités et voter pour vos préférées dans l'outil de suivi des problèmes.

Se connecter à PostgreSQL

Le connecteur PostgreSQL utilise le pilote JDBC PostgreSQL pour associer une source de données Data Studio à une table de base de données PostgreSQL unique ou à une requête personnalisée que vous fournissez.

Pour vous connecter à votre base de données PostgreSQL, procédez comme suit :

  1. Connectez-vous à Data Studio.
  2. Sur la page d'accueil de Data Studio, cliquez sur Créer, puis sélectionnez Source de données.
  3. Sélectionnez le connecteur PostgreSQL.
  4. Si vous y êtes invité, autorisez Data Studio à accéder à vos données.
  5. Configurez l'accès à votre base de données à l'aide de l'une des options de connexion.
  6. Cliquez sur AUTHENTICATE (AUTHENTIFIER). La liste des tables incluses dans cette base de données s'affiche.
  7. Sélectionnez une table dans la liste ou saisissez une requête personnalisée.
  8. Cliquez sur ASSOCIER.

Vous pouvez maintenant accéder à toutes les colonnes du tableau, sous forme de champs dans vos rapports.

Options de connexion

Se connecter à l'aide d'un nom d'hôte ou d'une adresse IP

Dans le panneau de connexion, sélectionnez STANDARD. Saisissez les informations de connexion :

  • Nom d'hôte ou adresse IP
  • Port (facultatif)
  • Base de données
  • Nom d'utilisateur
  • Mot de passe

Se connecter à l'aide d'une URL JDBC

Dans le panneau de connexion, sélectionnez URL JDBC. Saisissez les informations de connexion :

  • URL JDBC

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

    • Pour Cloud SQL (adresse IP privée) jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE

  • Nom d'utilisateur
  • Mot de passe

Pour vous connecter à l'aide d'une adresse IPv6 littérale, placez-la entre crochets. Par exemple : jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

Se connecter à l'aide de SSL

Data Studio accepte les connexions sécurisées (chiffrées) au serveur à l'aide du protocole TLS (Transport Layer Security) (TLS 1.2). également désigné par l'acronyme SSL (Secure Sockets Layer).

Pour activer une connexion sécurisée, sélectionnez Activer SSL, puis fournissez vos fichiers de configuration SSL.

Se connecter à l'aide de l'authentification client

Lorsque la case Activer l'authentification du client est cochée, vous pouvez importer une clé privée et un certificat client si l'accès à votre base de données est requis.

En savoir plus sur les connexions sécurisées PostgreSQL

Requête personnalisée

Sélectionnez l'option REQUÊTE PERSONNALISÉE pour fournir une requête SQL au lieu d'établir une connexion à un seul tableau. Data Studio utilise ce code SQL personnalisé comme instruction de sélection interne pour chaque requête générée vers la base de données.

Les requêtes SQL personnalisées ne peuvent avoir qu'une seule instruction. Par exemple, la requête suivante ne fonctionnera pas, car elle comporte plusieurs instructions SQL :


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;

Les requêtes dans Data Studio peuvent expirer au bout de trois à cinq minutes. Si vos requêtes personnalisées expirent, essayez les approches suivantes pour résoudre le problème :

  • Simplifiez la requête pour qu'elle s'exécute plus rapidement.
  • Exécutez la requête dans votre base de données et stockez les résultats dans une table distincte. Connectez la nouvelle table dans votre source de données.

Types de données acceptés

Le connecteur PostgreSQL est compatible avec les types de données suivants :

  • Numérique
  • Caractère
  • Booléen
  • Date/Heure (sauf les intervalles)

Lorsque Data Studio rencontre un type de colonne non compatible, aucun champ n'est créé pour cette colonne.

En savoir plus sur les types de données PostgreSQL

Connexions publiques et privées

Data Studio est compatible avec les connexions IP publiques et privées à PostgreSQL sur Cloud SQL.

Pour vous connecter à l'aide d'une adresse IP privée, vous devez utiliser l'option de connexion URL JDBC au format jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE. De plus, vous devez sélectionner l'option Chemin d'accès privé pour les services Google Cloud dans les paramètres de votre instance Cloud SQL.

Pare-feu et accès à la base de données

Pour autoriser Data Studio à se connecter aux bases de données qui se trouvent derrière un pare-feu et à les interroger, vous devez ouvrir l'accès à l'une des adresses IP suivantes. Vous devrez peut-être également configurer votre base de données pour qu'elle accepte le trafic provenant de ces adresses. Pour savoir comment procéder, consultez la documentation de votre base de données.

Adresses IP

Les adresses suivantes sont réservées à l'infrastructure mondiale de Data Studio :

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (facultatif, pour les plates-formes compatibles avec IPv6)

Si vous avez activé la résidence des données pour votre abonnement Data Studio Pro, utilisez plutôt les adresses suivantes :

  • 142.251.56.0/24

  • 2001:4860:4815::/48 (facultatif, pour les plates-formes compatibles avec IPv6)

Limites du connecteur PostgreSQL

  • Le connecteur PostgreSQL n'utilise pas le proxy Cloud SQL lors de la connexion aux instances PostgreSQL Cloud SQL. Si vous vous connectez à une instance Cloud SQL pour PostgreSQL à l'aide d'une adresse IP publique, vous devrez ajouter les adresses IP indiquées à la liste des réseaux autorisés. Consultez la documentation Cloud SQL.

  • La connexion aux sources de données AlloyDB via SSL n'est pas prise en charge, car AlloyDB ne permet pas d'exporter les certificats d'autorité de certification (CA).

  • La sélection d'une table en dehors du schéma public n'est pas acceptée. Toutefois, vous pouvez sélectionner l'option REQUÊTE PERSONNALISÉE pour écrire une requête qui inclut les tables de n'importe quel schéma.

  • Ce connecteur vous permet de lancer une requête sur 150 000 lignes par requête au maximum. Si vous dépassez cette limite, les données seront tronquées.

  • Les en-têtes de colonne (noms de champs) ne doivent contenir que des caractères ASCII. Les caractères non ASCII ne sont pas acceptés.

Dépannage

Consultez le guide de dépannage de Data Studio pour obtenir la liste des messages d'erreur courants et la marche à suivre pour les résoudre.

Créer une source de données