Se connecter avec psql
Débutantpsql est le client officiel en ligne de commande : il sert à explorer une base, tester une requête et diagnostiquer un problème en production.
psql -h localhost -U app -d ma_base # hôte, utilisateur, base
psql "postgresql://app:secret@localhost:5432/ma_base" # URL de connexion
psql -f schema.sql # exécuter un fichier
psql -c "SELECT now();" # exécuter une seule commande
Les méta-commandes utiles#
Elles commencent par \ et sont propres à psql (ce n'est pas du SQL).
| Commande | Effet |
|---|---|
\l | Lister les bases |
\c ma_base | Se connecter à une autre base |
\dt | Lister les tables du schéma courant |
\d utilisateurs | Décrire une table : colonnes, index, contraintes, clés étrangères |
\d+ utilisateurs | Idem avec la taille et plus de détails |
\di, \dv, \df | Lister les index, les vues, les fonctions |
\x | Basculer l'affichage vertical (lisible pour les lignes larges) |
\timing | Afficher la durée de chaque requête |
\q | Quitter |
Astuce :
\x autobascule automatiquement en affichage vertical quand la ligne est trop large pour le terminal. Mettez-le dans~/.psqlrcavec\timing onpour l'avoir en permanence.