Postgres Patterns

作者 affaan-mef648e01899b无许可证275K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库3天前更新

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.

AI 生成的概览

PostgreSQL 模式速查指南,涵盖查询优化、模式设计、索引与安全。

功能
提供 PostgreSQL 最佳实践的简明参考,涵盖索引选择、数据类型选择、常见查询模式(如 upsert 和游标分页)以及行级安全策略。还包含用于查找未建索引外键、慢查询和表膨胀的诊断 SQL,以及连接数、超时和监控的配置模板。产出是指导说明和 SQL 片段,而非可执行工具。
适用场景
适用于编写 SQL 查询或迁移、设计数据库模式、诊断慢查询、实现行级安全或配置连接池的场景。它旨在作为处理 PostgreSQL 数据库时的快速查阅参考。
运行要求
无需脚本或运行时,仅为说明性参考。应用诊断查询需要 PostgreSQL 数据库,部分片段涉及 pg_stat_statements 等扩展。

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 ConsultaTipo de ÍndiceEjemplo
WHERE col = valueB-tree (por defecto)CREATE INDEX idx ON t (col)
WHERE col > valueB-treeCREATE INDEX idx ON t (col)
WHERE a = x AND b > yCompuestoCREATE INDEX idx ON t (a, b)
WHERE jsonb @> '{}'GINCREATE INDEX idx ON t USING gin (col)
WHERE tsv @@ queryGINCREATE INDEX idx ON t USING gin (col)
Rangos de series temporalesBRINCREATE INDEX idx ON t USING brin (col)

Referencia Rápida de Tipos de Datos

Caso de UsoTipo CorrectoEvitar
IDsbigintint, UUID aleatorio
Cadenastextvarchar(255)
Timestampstimestamptztimestamp
Dineronumeric(10,2)float
Flagsbooleanvarchar, int

Patrones Comunes

Orden del Índice Compuesto:

sql
-- Columnas de igualdad primero, luego columnas de rangoCREATE INDEX idx ON orders (status, created_at);-- Funciona para: WHERE status = 'pending' AND created_at > '2024-01-01'

Índice de Cobertura:

sql
CREATE INDEX idx ON users (email) INCLUDE (name, created_at);-- Evita la búsqueda en tabla para SELECT email, name, created_at

Índice Parcial:

sql
CREATE INDEX idx ON users (email) WHERE deleted_at IS NULL;-- Índice más pequeño, solo incluye usuarios activos

Política RLS (Optimizada):

sql
CREATE POLICY policy ON orders  USING ((SELECT auth.uid()) = user_id);  -- ¡Envolver en SELECT!

UPSERT:

sql
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:

sql
SELECT * FROM products WHERE id > $last_id ORDER BY id LIMIT 20;-- O(1) vs OFFSET que es O(n)

Procesamiento de Cola:

sql
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

sql
-- Encontrar claves foráneas sin índiceSELECT conrelid::regclass, a.attnameFROM pg_constraint cJOIN 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 lentasSELECT query, mean_exec_time, callsFROM pg_stat_statementsWHERE mean_exec_time > 100ORDER BY mean_exec_time DESC;
-- Verificar bloat de tablasSELECT relname, n_dead_tup, last_vacuumFROM pg_stat_user_tablesWHERE n_dead_tup > 1000ORDER BY n_dead_tup DESC;

Plantilla de Configuración

sql
-- Límites de conexión (ajustar según RAM)ALTER SYSTEM SET max_connections = 100;ALTER SYSTEM SET work_mem = '8MB';
-- TimeoutsALTER SYSTEM SET idle_in_transaction_session_timeout = '30s';ALTER SYSTEM SET statement_timeout = '30s';
-- MonitoreoCREATE EXTENSION IF NOT EXISTS pg_stat_statements;
-- Valores predeterminados de seguridadREVOKE 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)

来源与署名

来源:affaan-m/ecc位于docs/es/skills/postgres-patterns提交ef648e0

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架