</>
Plan du cours — 1/64

Se connecter avec psql

Débutant

psql 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).

CommandeEffet
\lLister les bases
\c ma_baseSe connecter à une autre base
\dtLister les tables du schéma courant
\d utilisateursDécrire une table : colonnes, index, contraintes, clés étrangères
\d+ utilisateursIdem avec la taille et plus de détails
\di, \dv, \dfLister les index, les vues, les fonctions
\xBasculer l'affichage vertical (lisible pour les lignes larges)
\timingAfficher la durée de chaque requête
\qQuitter

Astuce : \x auto bascule automatiquement en affichage vertical quand la ligne est trop large pour le terminal. Mettez-le dans ~/.psqlrc avec \timing on pour l'avoir en permanence.