Postgres Patterns

affaan-m/ECC/docs/ko-KR/skills/postgres-patterns

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

쿼리 최적화, 스키마 설계, 인덱싱, 보안을 위한 PostgreSQL 데이터베이스 패턴. Supabase 모범 사례 기반.

AI 生成的概览

用于查询优化、模式设计、索引、安全和配置的 PostgreSQL 参考模式。

功能
提供 PostgreSQL 最佳实践的快速参考,包括索引速查表、数据类型建议,以及复合索引、覆盖索引、部分索引、RLS 策略、UPSERT、游标分页和队列处理等常见 SQL 模式。还包含用于检测未索引外键、慢查询和表膨胀的反模式查询,以及连接数限制、超时、监控和安全默认值的配置模板。该技能仅为说明性内容,不生成文件或脚本。
适用场景
适用于编写 SQL 查询或迁移、设计数据库模式、排查慢查询、实现行级安全(RLS)或配置连接池的场景。
运行要求
除智能体外无需任何工具、软件包或凭据;仅为说明性内容,不附带脚本。部分引用的查询依赖 PostgreSQL 扩展,例如 pg_stat_statements。

PostgreSQL 패턴

PostgreSQL 모범 사례 빠른 참조. 자세한 가이드는 database-reviewer 에이전트를 사용하세요.

활성화 시점

  • SQL 쿼리 또는 마이그레이션을 작성할 때
  • 데이터베이스 스키마를 설계할 때
  • 느린 쿼리를 문제 해결할 때
  • Row Level Security를 구현할 때
  • 커넥션 풀링을 설정할 때

빠른 참조

인덱스 치트 시트

쿼리 패턴인덱스 유형예시
WHERE col = valueB-tree (기본값)CREATE INDEX idx ON t (col)
WHERE col > valueB-treeCREATE INDEX idx ON t (col)
WHERE a = x AND b > yCompositeCREATE 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)
시계열 범위BRINCREATE INDEX idx ON t USING brin (col)

데이터 타입 빠른 참조

사용 사례올바른 타입지양
IDbigintint, random UUID
문자열textvarchar(255)
타임스탬프timestamptztimestamp
금액numeric(10,2)float
플래그booleanvarchar, int

일반 패턴

복합 인덱스 순서:

sql
-- Equality columns first, then range columnsCREATE INDEX idx ON orders (status, created_at);-- Works for: WHERE status = 'pending' AND created_at > '2024-01-01'

커버링 인덱스:

sql
CREATE INDEX idx ON users (email) INCLUDE (name, created_at);-- Avoids table lookup for SELECT email, name, created_at

부분 인덱스:

sql
CREATE INDEX idx ON users (email) WHERE deleted_at IS NULL;-- Smaller index, only includes active users

RLS 정책 (최적화):

sql
CREATE POLICY policy ON orders  USING ((SELECT auth.uid()) = user_id);  -- Wrap in 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;

커서 페이지네이션:

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

큐 처리:

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 *;

안티패턴 감지

sql
-- Find unindexed foreign keysSELECT 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)  );
-- Find slow queriesSELECT query, mean_exec_time, callsFROM pg_stat_statementsWHERE mean_exec_time > 100ORDER BY mean_exec_time DESC;
-- Check table bloatSELECT relname, n_dead_tup, last_vacuumFROM pg_stat_user_tablesWHERE n_dead_tup > 1000ORDER BY n_dead_tup DESC;

구성 템플릿

sql
-- Connection limits (adjust for 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';
-- MonitoringCREATE EXTENSION IF NOT EXISTS pg_stat_statements;
-- Security defaultsREVOKE ALL ON SCHEMA public FROM public;
SELECT pg_reload_conf();

관련 항목

  • 에이전트: database-reviewer - 전체 데이터베이스 리뷰 워크플로우
  • 스킬: clickhouse-io - ClickHouse 분석 패턴
  • 스킬: backend-patterns - API 및 백엔드 패턴

Supabase Agent Skills 기반 (크레딧: Supabase 팀) (MIT License)

来源与署名

来源:affaan-m/ECC位于docs/ko-KR/skills/postgres-patterns提交ef648e0

许可证: 无许可证

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

举报或申请下架