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.
Ouvrir cette connexion dans SQLly
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é | Synonymes | Par défaut | Ce 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é | Synonymes | Par défaut | Ce 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é | Synonymes | Par défaut | Ce 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.
Autres moteurs
- Chaînes de connexion SQL Server
- Chaînes de connexion MySQL
- Chaînes de connexion MariaDB
- Chaînes de connexion SQLite
- Chaînes de connexion Oracle
- Chaînes de connexion Redis
- Chaînes de connexion ClickHouse
- Chaînes de connexion DuckDB
- Chaînes de connexion libSQL
- Tous les moteurs et formats
- Formateur SQL
- Tous les outils gratuits
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.