PostgreSQL 무중단 스키마 마이그레이션

무엇을 해주나

• ALTER TABLE, 인덱스/제약 추가 등 모든 주요 DDL의 락 레벨을 빠른 작업/블로킹 작업으로 분류한 참조표를 제공합니다.
• 컬럼 추가·삭제·이름 변경·타입 변경, NOT NULL·FK·UNIQUE 추가, PK 재정의 등에 대한 무중단 안전 패턴 SQL을 단계별로 제시합니다.
• lock_timeout / statement_timeout 설정, 재시도 루프(lock_not_available 예외 처리), LOCK TABLE ... NOWAIT 전략을 비교해 줍니다.
• 배치 백필, 마이그레이션 전/후 검증 쿼리, 롤백 가능/불가능 작업 구분, 포크(fork) 기반 리허설 절차를 안내합니다.
• 빈 테이블에서만 테스트하기, CONCURRENTLY 누락, invalid 인덱스 방치 등 9가지 흔한 실수를 짚어 줍니다.

이런 분께 추천

• 수백만 행 규모의 운영 PostgreSQL을 다루는 백엔드 개발자·DBA·플랫폼 엔지니어
• Rails/Django/Prisma 등 마이그레이션 도구가 생성한 SQL이 정말 안전한지 검토받고 싶은 팀
• 배포와 스키마 변경을 조율해 다운타임 없이 릴리스해야 하는 조직

활용 예시

1. "orders 테이블에 created_at TIMESTAMPTZ DEFAULT now() 추가하려는데 안전한가?" → 휘발성 기본값으로 인한 전체 테이블 재작성 위험을 지적하고 nullable 추가 → 배치 백필 → SET DEFAULT/NOT NULL 순서로 다시 작성해 줍니다.
2. "1천만 행 테이블에 user_id 인덱스를 추가해야 해" → CREATE INDEX CONCURRENTLY 사용, 트랜잭션 밖 실행, 실패 시 pg_index.indisvalid 확인 및 정리까지 체크리스트로 안내.
3. "amount를 INTEGER에서 NUMERIC으로 바꿔야 해" → 새 컬럼 추가 + 배치 백필 + 컬럼 스왑 패턴과 롤백 계획, 포크에서 먼저 리허설하는 절차를 제시.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/timescale/pg-aiguide/HEAD/skills/postgres-database-migration/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 timescale/pg-aiguide 의 skills/postgres-database-migration 폴더를 내 ~/.claude/skills/postgres-database-migration/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.