Menu

PostgreSQL: listar bases de datos y mostrar tablas

En psql, \l lista las bases de datos, \c cambia a una y \dt lista sus tablas. En SQL, consulta pg_database, information_schema.tables e information_schema.columns.

Esta página incluye editores ejecutables: edita, ejecuta y ve el resultado al instante.

En psql, \l lista las bases de datos, \c dbname se conecta a una y \dt lista las tablas de la base de datos actual. Desde SQL o cualquier otro cliente, consulta los catálogos: pg_database para las bases de datos e information_schema.tables para las tablas.

Devuelve las dos tablas como BASE TABLE y la vista como VIEW, todas en el esquema public. El filtro WHERE oculta los catálogos del sistema, que si no añadirían cientos de filas. Agrega AND table_type = 'BASE TABLE' para dejar fuera las vistas.

Comandos de psql para bases de datos y tablas

Son metacomandos de psql. psql convierte cada uno en una consulta a los catálogos, así que no funcionan en otros clientes ni en el código de una aplicación.

ComandoMuestra
\lLas bases de datos (\l+ añade tamaños)
\c shopSe conecta a la base de datos shop
\conninfoLa base de datos, el usuario y el host en los que estás
\dnLos esquemas
\dtLas tablas de los esquemas de tu search_path
\dt sales.*Las tablas del esquema sales
\dt *.*Las tablas de todos los esquemas, incluidos los del sistema
\dt+Las tablas con tamaño y descripción
\dv, \di, \dsVistas, índices, secuencias
\d ordersColumnas, índices y restricciones de orders
\d+ ordersLo mismo más almacenamiento y comentarios
\duLos roles

Desde la terminal, psql -l imprime la lista de bases de datos y termina, y -c ejecuta un solo comando:

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

Inicia psql con -E para ver el SQL que hay detrás de cada metacomando. Es una forma rápida de aprender las tablas del catálogo.

Listar bases de datos con SQL

Cada base de datos del servidor es una fila de pg_database. template0 y template1 son las plantillas que copia CREATE DATABASE, así que fíltralas:

En esta página cada ejecución recibe una base de datos nueva cuyo nombre empieza por lesson_. El resultado la muestra junto a postgres, la base de datos por defecto que crea todo servidor. SELECT current_database() devuelve la base de datos a la que estás conectado.

Describir las columnas de una tabla

En psql, \d orders describe la tabla. En SQL, information_schema.columns tiene una fila por columna:

id muestra NO en is_nullable porque una clave primaria siempre es NOT NULL. Su column_default está vacío: una columna identity toma sus valores de una secuencia, no de un valor por defecto.

Consultar pg_catalog directamente

information_schema es la vista del estándar SQL y solo muestra los objetos sobre los que tienes algún privilegio. Los catálogos propios de PostgreSQL en pg_catalog tienen más información, como las definiciones de los índices:

Lista tres índices: orders_email_key, que viene de UNIQUE, orders_pkey, de la clave primaria, y el parcial que creaste. Cada uno trae la sentencia CREATE INDEX que lo volvería a crear. pg_tables solo lista tablas; pg_views y pg_matviews cubren las vistas y las vistas materializadas.

Contar las filas de todas las tablas

Los catálogos no guardan el número exacto de filas. pg_class.reltuples tiene la estimación del planificador, que actualizan VACUUM y ANALYZE. Basta para detectar las tablas grandes, y -1 significa que la tabla nunca se analizó:

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

Para un número exacto, ejecuta SELECT count(*) FROM orders, que lee la tabla entera. Las tablas del catálogo están documentadas en System Catalogs, dentro del manual de PostgreSQL.

Preguntas frecuentes

¿PostgreSQL tiene SHOW TABLES o SHOW DATABASES?

No, son comandos de MySQL. En PostgreSQL, SHOW lee un parámetro del servidor, así que SHOW TABLES falla con "unrecognized configuration parameter". Usa \dt y \l en psql, o consulta information_schema.tables y pg_database.

¿Por qué \dt dice "Did not find any relations"?

O estás conectado a una base de datos distinta de la que tiene las tablas, o las tablas están en un esquema que no está en tu search_path. Revisa \conninfo y prueba \dt *.* o \dt schema_name.*.

¿Cómo cambio de base de datos en PostgreSQL?

Una conexión pertenece a una sola base de datos, y SQL no tiene sentencia USE. En psql ejecuta \c other_db, que abre una conexión nueva; desde la terminal, inicia psql -d other_db.

¿Cómo veo el tamaño de las tablas en PostgreSQL?

En psql, \dt+ añade una columna de tamaño. En SQL, pg_size_pretty(pg_total_relation_size('orders')) da el tamaño de una tabla con sus índices y sus datos TOAST.

Ilustración de los lenguajes de programación de Coddy

Aprende a programar con Coddy

Comenzar