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.
| Comando | Muestra |
|---|---|
\l | Las bases de datos (\l+ añade tamaños) |
\c shop | Se conecta a la base de datos shop |
\conninfo | La base de datos, el usuario y el host en los que estás |
\dn | Los esquemas |
\dt | Las 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, \ds | Vistas, índices, secuencias |
\d orders | Columnas, índices y restricciones de orders |
\d+ orders | Lo mismo más almacenamiento y comentarios |
\du | Los 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.