PostgreSQL 테이블을 하이퍼테이블로 마이그레이션

무엇을 해주나

• 최적 설정 도출: 파티션 컬럼(timestamp/created_at/id 등) 후보를 조회해 고르고, RAM 대비 인덱스 크기를 계산해 청크 간격(chunk_time_interval)을 산정합니다. 확신이 없으면 기본 7일을 유지하도록 안내합니다.
• 제약조건 점검: PK/UNIQUE에 파티션 컬럼이 포함되는지 검사하고, 변경이 필요하면 사용자 승인 없이는 절대 수정하지 않도록 규칙을 강제합니다. 하이퍼테이블→하이퍼테이블 외래키는 미지원이므로 중단 조건으로 처리합니다.
• 마이그레이션 실행 계획: 1GB 미만은 in-place(create_hypertable), 1GB 초과는 블루-그린(신규 테이블 생성 → 배치 복사 → 점검 창에서 스왑) 절차를 SQL과 함께 제시합니다.
• 압축(컬럼스토어) 구성: segmentby/orderby/sparse index 선택 기준과 add_columnstore_policy 설정을 알려줍니다.
• 사후 검증: 청크 분포·압축률 조회, EXPLAIN (ANALYZE, BUFFERS)로 청크 제외·ColumnarScan 확인, 인덱스 과다로 인한 INSERT 저하 진단, 지속 모니터링 뷰까지 제공합니다.

이런 분께 추천

• 시계열·로그·이벤트 데이터가 쌓여 테이블이 비대해진 PostgreSQL을 운영하는 백엔드/데이터 엔지니어
• TimescaleDB 도입을 검토 중이거나 이미 확장을 설치했지만 전환 절차가 막막한 팀
• 다운타임을 최소화한 대용량 테이블 전환 계획을 문서화해야 하는 DBA/SRE

활용 예시

1. "sensor_readings 테이블(120GB)을 하이퍼테이블로 옮기고 싶어. 다운타임 최소화 계획 세워줘" → 블루-그린 절차, 배치 복사 쿼리, 스왑 트랜잭션, 예상 소요 시간(약 75k rows/s 기준) 산출.
2. "청크 간격을 몇으로 잡아야 해? 서버 RAM은 64GB야" → 시간당 인덱스 증가량을 계산해 최근 청크 인덱스가 RAM의 25% 아래가 되는 최대 간격 추천.
3. "전환은 끝났는데 압축률이 60%밖에 안 나와" → 세그먼트별 행 수를 분석해 segmentby 선택이 잘못됐는지 진단하고 order_by/sparse index 재구성 제안.

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

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

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