// outil gratuit

Constructeur de chaîne de connexion PostgreSQL

Créez un URI de connexion PostgreSQL, une chaîne mot-clé/valeur libpq, une chaîne Npgsql (ADO.NET), une URL JDBC et plus encore à partir d’un seul formulaire, ou collez l’une d’elles pour voir ce que fait chaque paramètre et si sslmode vous protège réellement. Tout fonctionne dans votre navigateur : rien de ce que vous tapez n'est envoyé quelque part.

Ouvrir cette connexion dans SQLly

Ouvre l'éditeur de connexion de SQLly, prérempli.

Privé par conception. Le constructeur et le décodeur sont du JavaScript pur fonctionnant dans cet onglet. La page n'envoie aucune requête avec ce que vous tapez, ne stocke rien (pas même dans votre navigateur) et continue de fonctionner hors ligne une fois chargée. Le lien Ouvrir dans SQLly va directement de votre navigateur à l'application sur votre ordinateur.

Formats de chaîne de connexion PostgreSQL

La plupart des pilotes PostgreSQL reposent sur libpq ou copient ses règles, donc l’URI postgresql://user:password@host:5432/db?sslmode=verify-full et la forme mot-clé/valeur host=... dbname=... fonctionnent presque partout : psql, psycopg, pgx, lib/pq, node-postgres. Npgsql (.NET) et pgJDBC (Java) ont leurs propres écritures.

Le paramètre le plus important est sslmode. Sa valeur par défaut, prefer, utilise TLS lorsque le serveur le propose mais ne vérifie jamais le certificat et retombe silencieusement sur le texte brut. Seul verify-full vérifie à la fois la chaîne de certificats et le nom de l'hôte.

URI libpq, psql, psycopg, pgx, node-postgres, Prisma

postgresql://app_user:[email protected]/sales?sslmode=verify-full

Mot-clé/valeur libpq conninfo, psycopg, pgx, lib/pq

host=db.example.com dbname=sales user=app_user password=your_password sslmode=verify-full

ADO.NET (Npgsql) Npgsql, Entity Framework Core

Host=db.example.com;Database=sales;Username=app_user;Password=your_password;SSL Mode=VerifyFull

JDBC Pilote JDBC PostgreSQL (pgJDBC)

jdbc:postgresql://db.example.com/sales?user=app_user&password=your_password&sslmode=verify-full

ODBC psqlODBC

Driver={PostgreSQL Unicode};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SSLmode=verify-full;

URL SQLAlchemy Python SQLAlchemy avec psycopg 3

postgresql+psycopg://app_user:[email protected]/sales?sslmode=verify-full

Plusieurs hôtes (basculement) libpq 10+, pgx, Npgsql, pgJDBC

postgresql://[email protected]:5432,db2.example.com:5432/sales?target_session_attrs=read-write

Espaces réservés tels que your_password sont exactement cela : construisez votre propre chaîne avec le formulaire ci-dessus. Pour en savoir plus sur la connexion de SQLly à PostgreSQL : SQLly pour PostgreSQL.

Paramètres libpq (URI et mot-clé/valeur)

Forme URI : postgresql://[user[:password]@][host][:port][,...][/dbname][?param=value&...] (postgres:// fonctionne aussi) ; encodez en pourcentage les caractères spéciaux, y compris les barres obliques d'un chemin de socket Unix utilisé comme hôte. Forme mot-clé/valeur : key=value paires séparées par des espaces ; mettez entre guillemets simples une valeur qui est vide ou qui contient des espaces, et écrivez \' et \\ pour une apostrophe ou un antislash à l'intérieur.

Mot-cléSynonymesPar défautCe que cela fait
host - Socket Unix dans /tmp (localhost sur Windows) Nom d'hôte, IP ou un répertoire pour un socket Unix. Une liste séparée par des virgules est essayée dans l'ordre.
hostaddr - - IP numérique, en contournant le DNS (l'hôte est toujours utilisé pour les vérifications TLS).
port - 5432 (valeur par défaut à la compilation) Un port, ou un par hôte.
dbname - le nom d'utilisateur Base de données à laquelle se connecter.
user - l'utilisateur du système d'exploitation Rôle pour se connecter.
password - - Mieux conservé dans ~/.pgpass (ou PGPASSWORD) que dans la chaîne.
passfile - ~/.pgpass (%APPDATA%\postgresql\pgpass.conf sur Windows) Fichier de mot de passe.
connect_timeout - 0 (attendre indéfiniment) Secondes par hôte. PostgreSQL 16 et les versions antérieures considèrent 1 comme 2.
sslmode - préférer disable, allow, prefer, require, verify-ca, verify-full. require vérifie la CA seulement si un fichier de certificat racine existe ; seulement verify-full vérifie le nom de l'hôte.
sslrootcert - ~/.postgresql/root.crt Fichier CA. system (16+) utilise les CAs de confiance du système d'exploitation et en fait verify-full la valeur par défaut.
sslcert / sslkey - ~/.postgresql/postgresql.crt / .key Certificat client et clé.
sslnegotiation - postgres 17+. direct démarre TLS immédiatement (nécessite sslmode require ou plus strict).
application_name - - Affiché dans pg_stat_activity et le journal du serveur.
options - - Paramètres du serveur au démarrage, par exemple -c statement_timeout=30000 -c search_path=app.
target_session_attrs - n'importe quel any, read-write, read-only, primary, standby, prefer-standby.
load_balance_hosts - désactiver 16+. random mélange la liste des hôtes.
keepalives - 1 TCP keepalives activés/désactivés ; ajustez avec keepalives_idle, keepalives_interval, keepalives_count.
channel_binding - préférer require refuse de s'authentifier sans liaison de canal SCRAM.

Paramètres Npgsql (ADO.NET)

Npgsql utilise ADO.NET Key=Value; avec ses propres noms de mots-clés. Mettez entre guillemets les valeurs contenant ; avec des guillemets doubles.

Mot-cléSynonymesPar défautCe que cela fait
Host Serveur - (requis) Nom d'hôte, IP, liste séparée par des virgules, ou un répertoire de sockets commençant par /.
Port - 5432 Port TCP.
Database BD le nom d'utilisateur Nom de la base de données.
Username Nom d'utilisateur, Identifiant utilisateur, UID PGUSER, sinon l'utilisateur du système d'exploitation Nom du rôle.
Password PSW, PWD PGPASSWORD Mot de passe.
SSL Mode SslMode Préférer Disable, Allow, Prefer, Require, VerifyCA, VerifyFull. Depuis Npgsql 6, Require ne valide pas le certificat.
Trust Server Certificate - faux Ignorer la validation. Npgsql 6 et 7 l'exigeaient avec Require; Npgsql 8 ne le fait pas.
Root Certificate - PGSSLROOTCERT Fichier CA pour VerifyCA / VerifyFull.
Timeout - 15 Secondes d'attente d'une connexion.
Command Timeout - 30 Délai d'exécution par défaut en secondes ; 0 attend indéfiniment.
Application Name - PGAPPNAME application_name.
Search Path - - Chemin de recherche du schéma.
Target Session Attributes - n'importe quel any, primary, standby, prefer-primary, prefer-standby, read-write, read-only.
Pooling - vrai Pool de connexions.
Maximum Pool Size - 100 Plus grand pool.
Minimum Pool Size - 0 Plus petit pool.
Keepalive - 0 (désactivé) Secondes entre les requêtes keepalive.
Include Error Detail - faux Met le détail de l'erreur du serveur, qui peut contenir des données de ligne, dans les messages d'exception.

Propriétés pgJDBC

Forme de l’URL : jdbc:postgresql://host:port/database?property=value&.... pgJDBC ne lit pas user:password@ dans l'URL : passez user et password comme paramètres ou propriétés de connexion.

Mot-cléSynonymesPar défautCe que cela fait
user / password - - Identifiants.
sslmode - préférer Mêmes valeurs que libpq. require, allow et prefer ne validez pas le certificat.
ssl - faux true sans sslmode signifie verify-full.
sslrootcert - ~/.postgresql/root.crt Fichier CA.
connectTimeout - 10 Secondes d'attente du socket ; 0 désactive la limite.
socketTimeout - 0 Secondes pendant lesquelles une lecture peut bloquer ; 0 attend indéfiniment.
loginTimeout - 0 Secondes d'attente de l'authentification complète.
ApplicationName - Pilote JDBC PostgreSQL application_name.
currentSchema - - search_path, séparé par des virgules.
targetServerType - n'importe quel any, primary, secondary, preferPrimary, preferSecondary.
options - - Options de démarrage, par ex. -c statement_timeout=30000 (encodé en pourcentage dans l'URL).

Erreurs de connexion PostgreSQL courantes

FATAL: no pg_hba.conf entry for host "10.0.0.7", user "app_user", database "sales", no encryption

Pourquoi : Le serveur atteint, mais aucune ligne dans pg_hba.conf autorise ce client, cet utilisateur et cette base de données, ou la ligne correspondante est hostssl et vous vous êtes connecté sans TLS (« aucun chiffrement »).

Correction : Se connecter avec sslmode=require ou plus fort si le serveur attend TLS, ou demandez à l'administrateur d'ajouter une host/hostssl ligne pour votre adresse et rechargez le serveur.

connection to server at "db.example.com" (10.0.0.5), port 5432 failed: Connection refused

Pourquoi : Rien n'écoute sur cette adresse et ce port : le serveur est éteint, listen_addresses ne couvre que localhost, le port est différent, ou un pare-feu rejette la connexion.

Correction : Vérifier listen_addresses et port dans postgresql.conf, le pare-feu ou le groupe de sécurité cloud, et si vous avez besoin d'un port différent (les services gérés et les poolers utilisent souvent 6432 ou un port personnalisé).

FATAL: password authentication failed for user "app_user"

Pourquoi : Mot de passe incorrect, un rôle sans mot de passe, ou un caractère spécial dans le mot de passe qui n'a pas été encodé en pourcentage dans l'URI, donc le pilote a lu un mot de passe différent.

Correction : Vérifiez le mot de passe ; dans une URI, encodez @ comme %40, : comme %3A, / comme %2F et % comme %25. Collez l'URI dans le décodeur pour voir exactement quel mot de passe le pilote enverra.

server does not support SSL, but SSL was required

Pourquoi : La chaîne demande sslmode=require (ou verify-ca / verify-full) et le serveur a ssl = off.

Correction : Activez TLS sur le serveur, ou connectez-vous au point de terminaison TLS documenté par votre fournisseur. Ne redescendez pas à sslmode=disable sur un réseau que vous ne contrôlez pas.

root certificate file "/home/app/.postgresql/root.crt" does not exist

Pourquoi : sslmode=verify-ca ou verify-full a besoin d'un certificat CA pour vérifier, et libpq n'en a trouvé aucun sur le chemin par défaut.

Correction : Téléchargez le bundle CA de votre fournisseur et définissez sslrootcert=/path/to/ca.pem, ou sur les clients PostgreSQL 16+ utilisez sslrootcert=system lorsque le certificat du serveur provient d'une CA publique.

FATAL: database "app_user" does not exist

Pourquoi : Non dbname a été fourni, donc libpq a utilisé le nom d'utilisateur comme nom de base de données.

Correction : Ajoutez la base de données au chemin URI (/sales) ou définissez dbname=sales.

invalid connection option "sslmod"

Pourquoi : libpq rejette toute la chaîne lorsqu'un mot-clé est mal orthographié ou appartient à un autre pilote (par exemple ApplicationName du pgJDBC au lieu de application_name).

Correction : Corrigez l'orthographe. Le décodeur liste tous les paramètres libpq et signale ceux qu'il ne connaît pas.

FAQ sur la chaîne de connexion PostgreSQL

Quel est le format de la chaîne de connexion PostgreSQL ?

Deux formes fonctionnent avec les pilotes basés sur libpq : l’URI postgresql://user:password@host:5432/dbname?sslmode=verify-full et la chaîne mot-clé/valeur host=host port=5432 dbname=dbname user=user sslmode=verify-full. Npgsql utilise Host=...;Database=...;Username=... et Java utilise jdbc:postgresql://host:5432/dbname.

Quel sslmode utiliser ?

verify-full avec sslrootcert pointer vers votre CA (ou system sur PostgreSQL 16+). require chiffre mais ne vérifie pas qui a répondu, et prefer, par défaut, peut retomber silencieusement sur le texte brut. Utilisez disable uniquement pour une socket ou localhost.

Comment puis-je échapper des caractères spéciaux dans une URI PostgreSQL ?

Encodez-les en pourcentage dans le nom d'utilisateur, le mot de passe et la base de données : @ est %40, : est %3A, / est %2F, # est %23, ? est %3F, % est %25 et un espace est %20. La forme mot-clé/valeur évite la plupart de ces problèmes : entourez la valeur de guillemets simples et échappez ' et \ avec un antislash.

Comment puis-je définir un délai d'attente pour une instruction dans la chaîne de connexion ?

Avec les pilotes basés sur libpq, ajoutez options=-c statement_timeout=30000 (millisecondes ; encodez-le en pourcentage dans une URI comme options=-c%20statement_timeout%3D30000). Npgsql a Command Timeout, un délai côté client en secondes.

Puis-je indiquer plusieurs hôtes pour le basculement ?

Oui. Écrivez postgresql://host1:5432,host2:5432/db ou host=host1,host2 port=5432,5432. libpq les essaie dans l'ordre ; ajoutez target_session_attrs=read-write pour ignorer les serveurs secondaires en lecture seule, ou load_balance_hosts=random (PostgreSQL 16+) pour répartir les connexions.

Pourquoi node-postgres vérifie-t-il le certificat avec sslmode=require ?

pg-connection-string traite actuellement sslmode=prefer, require et verify-ca comme verify-full et affiche un avertissement indiquant que cela changera pour correspondre aux significations de libpq dans une future version majeure. Ajoutez uselibpqcompat=true pour adopter dès maintenant le comportement de libpq, ou configurez ssl dans la configuration client à la place.

// sans passer par les chaînes de connexion

Connectez-vous une fois. Ensuite, écrivez simplement du SQL.

SQLly est un atelier SQL natif pour macOS, Windows et Linux. Collez une chaîne de connexion dans son éditeur de connexion, gardez les mots de passe dans votre trousseau système et profitez d'un IntelliSense conscient du schéma sur PostgreSQL et plus encore.