PostgreSQL 테이블 설계 가이드

무엇을 해주나

• 새 테이블을 만들거나 기존 스키마를 수정할 때 데이터 타입 선택 규칙(TEXT vs VARCHAR, TIMESTAMPTZ, NUMERIC for money, BIGINT IDENTITY vs UUID 등)을 강제합니다.
• 인덱스 전략(B-tree, GIN, GiST, BRIN, 부분/표현식/커버링 인덱스)과 제약조건(PK/FK/UNIQUE NULLS NOT DISTINCT/CHECK/EXCLUDE) 설계를 안내합니다.
• PostgreSQL 특유의 함정(FK 컬럼 자동 인덱스 없음, 시퀀스 갭, MVCC 데드 튜플, 식별자 소문자화)을 사전에 피하도록 알려줍니다.
• 업데이트 과다·인서트 과다·업서트 워크로드별 튜닝, 파티셔닝, 안전한 스키마 변경(DDL) 절차, JSONB 인덱싱 패턴, 주요 확장(pg_trgm, pgvector, PostGIS, TimescaleDB) 사용 지침을 제공합니다.

이런 분께 추천

• PostgreSQL을 쓰는 백엔드/데이터 엔지니어, 마이그레이션을 작성하는 개발자
• ORM 마이그레이션을 리뷰하거나 스키마 설계를 표준화하려는 팀
• 시계열·로그 데이터의 파티셔닝/인덱싱을 고민하는 분

활용 예시

1. "주문/사용자 테이블 스키마를 설계해줘" → IDENTITY PK, CHECK 상태값, FK 인덱스가 포함된 DDL 생성.
2. "이 JSONB 컬럼 쿼리가 느려요" → GIN(jsonb_path_ops) vs 생성 컬럼 + B-tree 인덱스 선택 근거 제시.
3. "1억 행 로그 테이블을 어떻게 나눠야 하나요?" → RANGE 파티셔닝, BRIN 인덱스, 보존 정책 관점의 설계 제안.

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

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

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