Catálogos del Sistema

PostgreSQL almacena su propio esquema en catálogos del sistema (pg_catalog). Las vistas information_schema estándar de SQL envuelven un subconjunto para portabilidad. Los operadores y la automatización deben conocer ambos: los catálogos son completos; information_schema es familiar.

Receta

-- Tablas en la base de datos actual (estilo de catálogo)
SELECT n.nspname, c.relname, pg_total_relation_size(c.oid) AS bytes
FROM pg_class c
JOIN pg_namespace n ON n.oid = c.relnamespace
WHERE c.relkind IN ('r','p','m')
  AND n.nspname NOT IN ('pg_catalog','information_schema')
ORDER BY bytes DESC
LIMIT 20;

Cuándo usar esto: Necesitas introspeccionar esquemas, columnas, restricciones o tamaños sin herramientas externas.

Ejemplo de Trabajo

-- Detalle de columna con tipos y nulabilidad
SELECT table_schema, table_name, column_name, data_type, is_nullable
FROM information_schema.columns
WHERE table_schema = 'app' AND table_name = 'customers'
ORDER BY ordinal_position;
 
-- Restricciones en una tabla
SELECT conname, contype, pg_get_constraintdef(oid) AS definition
FROM pg_constraint
WHERE conrelid = 'app.customers'::regclass;

Lo que esto demuestra:

• information_schema.columns lista metadatos de columnas visibles para el usuario.
• pg_constraint almacena definiciones CHECK, UNIQUE, PRIMARY KEY y FOREIGN KEY.
• pg_total_relation_size incluye índices y TOAST para la planificación de capacidad.

Inmersión Profunda

Catálogos Clave

information_schema vs pg_catalog

• information_schema filtra objetos estándar de SQL y oculta detalles de implementación.
• pg_catalog es la fuente autorizada para particiones, políticas, disparadores y parámetros de almacenamiento.
• Une catálogos cuando necesites OIDs, relfilenode o amname (método de acceso).

Consejos de Descubrimiento

• Las conversiones regclass ('app.customers'::regclass) resuelven nombres usando search_path.
• psql \d+ nombre_tabla es una envoltura delgada sobre consultas a catálogos.

Trampas Comunes

• OID se desborda en clústeres de larga duración - Los clústeres muy antiguos rara vez alcanzan esto; aún así, usa nombres en el código de la aplicación. Solución: Prefiere conversiones regclass/regtype en scripts de administración.
• information_schema omite detalles de particiones - Los hijos de partición declarativa pueden parecer tablas ordinarias. Solución: Consulta pg_inherits y pg_partitioned_table.
• Gaps en pg_attribute.attnum - Las columnas eliminadas dejan huecos; filtra attnum > 0 y no eliminadas. Solución: Usa information_schema para listas de columnas portátiles.
• Las vistas de estadísticas no son catálogos - pg_stat_* son vistas sobre instantáneas de memoria compartida. Solución: Restablece las estadísticas con pg_stat_reset() con precaución en producción.
• search_path afecta a regclass - El mismo nombre no calificado puede resolverse de manera diferente por rol. Solución: Califica el esquema en herramientas y migraciones.

Alternativas

Preguntas Frecuentes

Relacionado

• Fundamentos de PostgreSQL - primeras consultas a catálogos
• Fundamentos de Diseño de Esquemas - nombres y claves
• Transacciones DDL - actualizaciones de catálogos durante migraciones

Versiones de la Pila: Esta página fue escrita para PostgreSQL 18.4 (estable 18, mantenimiento 17), pgvector 0.8+, PgBouncer 1.x, Patroni 3.x y PostGIS 3.5+.