postgres-patterns

name postgres-patterns description Patrones de base de datos PostgreSQL para optimización de consultas, diseño de esquemas, indexación y seguridad. Basado en las buenas prácticas de Supabase. origin ECC Patrones PostgreSQL Referencia rápida de las buenas prácticas de PostgreSQL. Para orientación detallada, usa el agente database-reviewer . Cuándo Activar Escribir consultas SQL o migraciones Diseñar esquemas de base de datos Diagnosticar consultas lentas Implementar Row Level Security Configurar connection pooling Referencia Rápida Tabla de Índices Patrón de Consulta Tipo de Índice Ejemplo WHERE col = value B-tree (por defecto) CREATE INDEX idx ON t (col) WHERE col > value B-tree CREATE INDEX idx ON t (col) WHERE a = x AND b > y Compuesto CREATE INDEX idx ON t (a, b) WHERE jsonb @> '{}' GIN CREATE INDEX idx ON t USING gin (col) WHERE tsv @@ query GIN CREATE INDEX idx ON t USING gin (col) Rangos de series temporales BRIN CREATE INDEX idx ON t USING brin (col) Referencia Rápida de Tipos de Datos Caso de Uso Tipo Correcto Evitar IDs bigint int , UUID aleatorio Cadenas text varchar(255) Timestamps timestamptz timestamp Dinero numeric(10,2) float Flags boolean varchar , int Patrones Comunes Orden del Índice Compuesto: -- Columnas de igualdad primero, luego columnas de rango CREATE INDEX idx ON orders (status, created_at); -- Funciona para: WHERE status = 'pending' AND created_at > '2024-01-01' Índice de Cobertura: CREATE INDEX idx ON users (email) INCLUDE (name, created_at); -- Evita la búsqueda en tabla para SELECT email, name, created_at Índice Parcial: CREATE INDEX idx ON users (email) WHERE deleted_at IS NULL ; -- Índice más pequeño, solo incluye usuarios activos Política RLS (Optimizada): CREATE POLICY policy ON orders USING (( SELECT auth.uid()) = user_id); -- ¡Envolver en SELECT! UPSERT: INSERT INTO settings (user_id, key, value ) VALUES ( 123 , 'theme' , 'dark' ) ON CONFLICT (user_id, key) DO UPDATE SET value = EXCLUDED.value; Paginación por Cursor: SELECT * FROM products WHERE id > $last_id ORDER BY id LIMIT 20 ; -- O(1) vs OFFSET que es O(n) Procesamiento de Cola: UPDATE jobs SET status = 'processing' WHERE id = ( SELECT id FROM jobs WHERE status = 'pending' ORDER BY created_at LIMIT 1 FOR UPDATE SKIP LOCKED ) RETURNING * ; Detección de Anti-Patrones -- Encontrar claves foráneas sin índice SELECT conrelid::regclass, a.attname FROM pg_constraint c JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = ANY (c.conkey) WHERE c.contype = 'f' AND NOT EXISTS ( SELECT 1 FROM pg_index i WHERE i.indrelid = c.conrelid AND a.attnum = ANY (i.indkey) ); -- Encontrar consultas lentas SELECT query, mean_exec_time, calls FROM pg_stat_statements WHERE mean_exec_time > 100 ORDER BY mean_exec_time DESC ; -- Verificar bloat de tablas SELECT relname, n_dead_tup, last_vacuum FROM pg_stat_user_tables WHERE n_dead_tup > 1000 ORDER BY n_dead_tup DESC ; Plantilla de Configuración -- Límites de conexión (ajustar según RAM) ALTER SYSTEM SET max_connections = 100 ; ALTER SYSTEM SET work_mem = '8MB' ; -- Timeouts ALTER SYSTEM SET idle_in_transaction_session_timeout = '30s' ; ALTER SYSTEM SET statement_timeout = '30s' ; -- Monitoreo CREATE EXTENSION IF NOT EXISTS pg_stat_statements; -- Valores predeterminados de seguridad REVOKE ALL ON SCHEMA public FROM public; SELECT pg_reload_conf(); Relacionado Agente: database-reviewer - Flujo de trabajo completo de revisión de base de datos Skill: clickhouse-io - Patrones de analítica en ClickHouse Skill: backend-patterns - Patrones de API y backend Basado en Agent Skills de Supabase (crédito: equipo de Supabase) (Licencia MIT)