PostgreSQL 패턴
PostgreSQL 모범 사례 빠른 참조. 자세한 가이드는 database-reviewer 에이전트를 사용하세요.
활성화 시점
- SQL 쿼리 또는 마이그레이션을 작성할 때
- 데이터베이스 스키마를 설계할 때
- 느린 쿼리를 문제 해결할 때
- Row Level Security를 구현할 때
- 커넥션 풀링을 설정할 때
빠른 참조
인덱스 치트 시트
| 쿼리 패턴 | 인덱스 유형 | 예시 |
|---|---|---|
WHERE col = value | B-tree (기본값) | CREATE INDEX idx ON t (col) |
WHERE col > value | B-tree | CREATE INDEX idx ON t (col) |
WHERE a = x AND b > y | Composite | 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) |
| 시계열 범위 | BRIN | CREATE INDEX idx ON t USING brin (col) |
데이터 타입 빠른 참조
| 사용 사례 | 올바른 타입 | 지양 |
|---|---|---|
| ID | bigint | int, random UUID |
| 문자열 | text | varchar(255) |
| 타임스탬프 | timestamptz | timestamp |
| 금액 | numeric(10,2) | float |
| 플래그 | boolean | varchar, int |
일반 패턴
복합 인덱스 순서:
-- Equality columns first, then range columns
CREATE INDEX idx ON orders (status, created_at);
-- Works for: WHERE status = 'pending' AND created_at > '2024-01-01'
커버링 인덱스:
CR…