postgres-best-practices

Postgres 작업을 위한 모범 사례와 지침입니다. 스키마 설계, 인덱싱 전략, 쿼리 최적화, 마이그레이션 및 일반적인 함정을 다룹니다. 사용…

Postgres Best Practices

Guidelines and best practices for working with Postgres, covering schema design, indexing, query optimization, and common pitfalls.

Supported Versions

This skill covers PostgreSQL 14 through 18. Version-specific features are tagged (e.g., [PG15+], [PG18+]); environment-dependent examples identify required privileges, extensions, or multi-node setup.

PostgreSQL provides 5 years of support per major version. Always run the latest minor release.

Version	Initial Release	End of Life
18	September 2025	November 2030
17	September 2024	November 2029
16	September 2023	November 2028
15	October 2022	November 2027
14	September 2021	November 2026

Source: postgresql.org/support/versioning

References

Area	Resource	When to Use
Schema Design	`references/schema-design.md`	Designing tables, choosing data types, normalizing, partitioning
Indexing	`references/indexing.md`	Choosing index types, composite indexes, partial/covering indexes
Query Optimization	`references/query-optimization.md`	Reading EXPLAIN ANALYZE, fixing bottlenecks, planner tuning
Query Patterns	`references/query-patterns.md`	CTEs, window functions, lateral joins, UPSERT, JSONB, anti-patterns
Performance Diagnostics	`references/performance-diagnostics.md`	pg_stat views, lock analysis, VACUUM, connection management
Logical Replication	`references/logical-replication.md`	Pub/sub replication, live migrations, CDC
Hot Standby	`references/hot-standby.md`	Streaming replication, read replicas, failover
Transaction Isolation	`references/transaction-isolation.md`	Isolation levels, lost updates, serialization failures, retry logic
Backup & Restore	`references/backup-restore.md`	pg_dump/pg_restore, pg_basebackup, PITR, recovery
Security & Roles	`references/security-roles.md`	Privileges, RLS, pg_hba.conf, authentication, SSL
Bulk Data Loading	`references/bulk-loading.md`	COPY patterns, ETL staging, optimizing large loads, batch ops
Connection Pooling	`references/connection-pooling.md`	PgBouncer config, pool modes, prepared statements, sizing
Major Version Upgrades	`references/major-version-upgrades.md`	pg_upgrade, logical replication migration, pre/post checklists