Menu

Lister les bases et les tables PostgreSQL (psql et SQL)

Dans psql, \l liste les bases de données, \c passe à l'une d'elles et \dt liste ses tables. En SQL, interrogez pg_database, information_schema.tables et information_schema.columns.

Cette page contient des éditeurs exécutables. Modifiez, exécutez et voyez la sortie instantanément.

Dans psql, \l liste les bases de données, \c dbname se connecte à l'une d'elles et \dt liste les tables de la base courante. Depuis SQL ou n'importe quel autre client, interrogez les catalogues : pg_database pour les bases et information_schema.tables pour les tables.

La requête renvoie les deux tables en BASE TABLE et la vue en VIEW, toutes dans le schéma public. Le filtre WHERE cache les catalogues système, qui ajouteraient sinon des centaines de lignes. Ajoutez AND table_type = 'BASE TABLE' pour exclure les vues.

Les commandes psql pour les bases et les tables

Ce sont des méta-commandes de psql. psql transforme chacune en requête sur les catalogues, donc elles ne marchent ni dans les autres clients ni dans le code d'une application.

CommandeAffiche
\lLes bases de données (\l+ ajoute les tailles)
\c shopSe connecte à la base shop
\conninfoLa base, l'utilisateur et l'hôte sur lesquels vous êtes
\dnLes schémas
\dtLes tables des schémas de votre search_path
\dt sales.*Les tables du schéma sales
\dt *.*Les tables de tous les schémas, y compris ceux du système
\dt+Les tables avec leur taille et leur description
\dv, \di, \dsLes vues, les index, les séquences
\d ordersLes colonnes, les index et les contraintes de orders
\d+ ordersLa même chose plus le stockage et les commentaires
\duLes rôles

Depuis le terminal, psql -l affiche la liste des bases et quitte, et -c lance une seule commande :

psql -l
psql -d shop -c '\dt'

Lancez psql avec -E pour afficher le SQL derrière chaque méta-commande. C'est une façon rapide d'apprendre les tables du catalogue.

Lister les bases de données en SQL

Chaque base du serveur est une ligne de pg_database. template0 et template1 sont les modèles que CREATE DATABASE copie, donc filtrez-les :

Sur cette page, chaque exécution reçoit une base neuve dont le nom commence par lesson_. Le résultat la montre avec postgres, la base par défaut que crée chaque serveur. SELECT current_database() renvoie celle à laquelle vous êtes connecté.

Décrire les colonnes d'une table

Dans psql, \d orders décrit la table. En SQL, information_schema.columns contient une ligne par colonne :

id affiche NO sous is_nullable parce qu'une clé primaire est toujours NOT NULL. Son column_default est vide : une colonne identity prend ses valeurs dans une séquence, pas dans une valeur par défaut.

Interroger directement pg_catalog

information_schema est la vue du standard SQL et ne montre que les objets sur lesquels vous avez un privilège. Les catalogues propres à PostgreSQL, dans pg_catalog, en contiennent davantage, comme les définitions des index :

La requête liste trois index : orders_email_key issu de UNIQUE, orders_pkey issu de la clé primaire et l'index partiel que vous avez créé. Chacun vient avec l'instruction CREATE INDEX qui le reconstruirait. pg_tables ne liste que les tables ; pg_views et pg_matviews couvrent les vues et les vues matérialisées.

Compter les lignes de chaque table

Les catalogues ne stockent pas le nombre exact de lignes. pg_class.reltuples contient l'estimation du planificateur, que VACUUM et ANALYZE mettent à jour. Elle est assez proche pour repérer les grosses tables, et -1 signifie que la table n'a jamais été analysée :

SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;

Pour un nombre exact, lancez SELECT count(*) FROM orders, qui lit toute la table. Les tables du catalogue sont documentées dans la section System Catalogs du manuel de PostgreSQL.

Questions fréquentes

PostgreSQL a-t-il SHOW TABLES ou SHOW DATABASES ?

Non, ce sont des commandes MySQL. En PostgreSQL, SHOW lit un paramètre du serveur, donc SHOW TABLES échoue avec « unrecognized configuration parameter ». Utilisez \dt et \l dans psql, ou interrogez information_schema.tables et pg_database.

Pourquoi \dt affiche-t-il « Did not find any relations » ?

Soit vous êtes connecté à une autre base que celle qui contient les tables, soit les tables sont dans un schéma qui n'est pas dans votre search_path. Vérifiez avec \conninfo, puis essayez \dt *.* ou \dt schema_name.*.

Comment changer de base de données en PostgreSQL ?

Une connexion appartient à une seule base, et SQL n'a pas d'instruction USE. Dans psql, lancez \c other_db, qui ouvre une nouvelle connexion ; depuis le terminal, lancez psql -d other_db.

Comment voir la taille des tables en PostgreSQL ?

Dans psql, \dt+ ajoute une colonne de taille. En SQL, pg_size_pretty(pg_total_relation_size('orders')) donne la taille d'une table, index et données TOAST compris.

Illustration des langages de programmation de Coddy

Apprendre à coder avec Coddy

Commencer