Qu'est-ce qu'une chaîne de connexion PostgreSQL ?

Une chaîne de connexion PostgreSQL est un texte formaté qui regroupe toutes les informations nécessaires pour se connecter à une base de données — nom d'hôte, port, identifiants, nom de la base de données et paramètres SSL — en une seule valeur. Les applications, les ORM et les outils en ligne de commande utilisent les chaînes de connexion pour établir des sessions de base de données sans nécessiter une configuration séparée de chaque paramètre. Il existe deux formats courants : le format URI (postgresql://user:password@host:port/dbname) et le format clé=valeur libpq (host=localhost port=5432 dbname=mydb). Les deux formats sont pris en charge par pratiquement toutes les bibliothèques clientes PostgreSQL.

Description de l'outil

Cet outil génère des chaînes de connexion PostgreSQL valides à partir de paramètres individuels. Remplissez l'hôte, le port, les identifiants, le nom de la base de données et le mode SSL, et il produit instantanément trois résultats prêts à l'emploi : une URL de connexion, une commande psql et une chaîne clé=valeur libpq.

Exemples

Entrée :

Champ Valeur
Hôte db.example.com
Port 5432
Nom d'utilisateur alice
Mot de passe s3cr3t
Base de données production
Mode SSL require

URL de connexion :

postgresql://alice:s3cr3t@db.example.com/production?sslmode=require

Commande psql :

psql "postgresql://alice:s3cr3t@db.example.com/production?sslmode=require"

Chaîne clé=valeur libpq :

host=db.example.com port=5432 dbname=production user=alice password=s3cr3t sslmode=require

Fonctionnalités

  • Trois formats de sortie : Génère simultanément une URL de connexion, une commande shell psql et une chaîne clé=valeur libpq
  • Sélecteur de mode SSL : Prend en charge les six modes SSL PostgreSQL — disable, allow, prefer, require, verify-ca et verify-full
  • Valeurs par défaut intelligentes : Omet les valeurs par défaut (port 5432, sslmode=prefer) pour garder la sortie propre et minimale
  • Encodage URL : Encode automatiquement en pourcentage les noms d'utilisateur, mots de passe et noms de base de données contenant des caractères spéciaux
  • Validation du port : Valide que le port est un nombre entre 1 et 65535

Cas d'utilisation

  • Configuration d'application : Générez une variable d'environnement DATABASE_URL pour des frameworks comme Django, Rails ou toute application utilisant une chaîne de connexion
  • Accès CLI rapide : Produisez une commande psql prête à exécuter pour vous connecter à une base de données distante sans mémoriser la syntaxe URI
  • Débogage de connexion : Construisez une chaîne libpq pour tester les connexions avec des pilotes de bas niveau ou des outils qui n'acceptent pas le format URI

Modes SSL expliqués

Mode Description
disable Pas de SSL. La connexion n'est pas chiffrée.
allow Utilise SSL si le serveur l'exige ; sinon se connecte sans SSL.
prefer Essaie d'abord SSL ; revient à une connexion non chiffrée (par défaut).
require Exige SSL mais ne vérifie pas le certificat du serveur.
verify-ca Exige SSL et vérifie que le certificat du serveur est signé par une autorité de certification de confiance.
verify-full Exige SSL, vérifie l'autorité de certification et vérifie également que le nom d'hôte correspond au certificat.