스킬 database-migration
🗄️

database-migration

안전 🌐 네트워크 접근⚙️ 외부 명령어

롤백 안전성과 함께 데이터베이스 마이그레이션 계획

또한 다음에서 사용할 수 있습니다: Doyajin174,CleanExpo

데이터베이스 마이그레이션을 서두르면 프로덕션을 손상시킬 수 있습니다. 이 기술은 Sequelize, TypeORM, Prisma에서 안전한 스키마 변경, 데이터 변환 및 롤백을 위한 검증된 패턴을 제공합니다.

지원: Claude Codex Code(CC)
📊 70 적절함
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"database-migration" 사용 중입니다. users.name을 users.full_name로 이름 변경을 위한 무중단 계획 제공

예상 결과:

  • 1단계: 기존 name 열 옆에 새로운 full_name 열 추가
  • 2단계: 두 열에 동시에 기록하는 코드 배포
  • 3단계: 배치로 name 값을 full_name에 복사하는 백필 실행
  • 4단계: 애플리케이션 읽기를 full_name 열로 전환
  • 5단계: 검증 후 별도 배포에서 이전 name 열 제거

"database-migration" 사용 중입니다. full_address 필드 마이그레이션을 위한 체크포인트 기반 롤백 전략 생성

예상 결과:

  • 마이그레이션 전에 CREATE TABLE AS SELECT로 백업 테이블 생성
  • 소규모 배치로 마이그레이션 수행하고 각 배치 후 검증
  • 실패 시 DROP TABLE 및 백업에서 CREATE TABLE AS SELECT로 복원
  • 성공적 검증 후 백업 테이블 삭제

보안 감사

안전
v4 • 1/17/2026

The static analyzer flagged 42 potential issues, but all are false positives. SKILL.md contains only documentation and code examples for database migration patterns. The 'weak cryptographic algorithm' findings were triggered by text patterns in documentation describing migration operations. The 'Ruby/shell backtick execution' findings misidentified command-line comments as shell execution. No actual executable code, credential access, or network exfiltration patterns exist. This is static instructional content only.

2
스캔된 파일
603
분석된 줄 수
2
발견 사항
4
총 감사 수

위험 요인

🌐 네트워크 접근 (1)
skill-report.json:6
⚙️ 외부 명령어 (25)
SKILL.md:23-50 SKILL.md:50-53 SKILL.md:53-92 SKILL.md:92-95 SKILL.md:95-105 SKILL.md:105-110 SKILL.md:110-125 SKILL.md:125-128 SKILL.md:128-161 SKILL.md:161-164 SKILL.md:164-175 SKILL.md:179-194 SKILL.md:194-199 SKILL.md:199-212 SKILL.md:216-238 SKILL.md:241-248 SKILL.md:248-253 SKILL.md:253-282 SKILL.md:282-285 SKILL.md:285-321 SKILL.md:321-326 SKILL.md:326-342 SKILL.md:346-358 SKILL.md:358-363 SKILL.md:363-394
감사자: claude 감사 이력 보기 →

품질 점수

38
아키텍처
100
유지보수성
87
콘텐츠
22
커뮤니티
100
보안
91
사양 준수

만들 수 있는 것

무중단 롤아웃

블루-그린 배포 전략을 활용하여 스키마 변경 중에도 애플리케이션을 가동 상태로 유지하는 단계별 마이그레이션을 계획합니다.

데이터 변환

대규모 데이터셋에 대한 체크포인트 기반 롤백 옵션이 포함된 안전한 데이터 백필 및 열 리팩토링을 설계합니다.

ORM 마이그레이션 전략

호환성 고려 사항과 함께 Sequelize, TypeORM, Prisma 간 전환 시 마이그레이션 접근 방식을 비교합니다.

이 프롬프트를 사용해 보세요

기본 마이그레이션 계획 
기본값이 있는 NOT NULL 상태 열을 Sequelize에 안전하게 추가하는 마이그레이션 계획을 생성하고, 롤백 단계 및 데이터 백필 고려 사항을 포함하세요.
무중단 이름 변경 
users.name을 users.full_name로 이름을 변경하기 위한 무중단 프로세스를 단계별 배포, 백필 전략 및 정리 단계와 함께 설명하세요.
데이터베이스 간 변경 
TypeORM에서 MySQL과 PostgreSQL 간 JSON 타입 차이점을 조건부 로직으로 처리하는 마이그레이션 접근 방식을 보여주세요.
고급 롤백 전략 
full_address 필드를 street, city, state, zip 구성 요소로 분할하는 데이터 마이그레이션을 위한 체크포인트 기반 롤백 전략을 설계하세요.

모범 사례

  • 모든 마이그레이션에 적절한 down() 메서드가 포함된 롤백 단계 항상 제공
  • 배포 전에 프로덕션을 미러링하는 스테이징 데이터에서 마이그레이션 테스트
  • 대규모 모놀리식 마이그레이션 대신 소규모 증분 스키마 변경 사용

피하기

  • 데이터 백필 및 애플리케이션 호환성 검증 전에 열 삭제
  • 트랜잭션 경계나 롤백 계획 없이 대규모 마이그레이션 실행
  • 변환 중 NULL 값 처리 및 외래 키 제약 조건 영향 무시

자주 묻는 질문

어떤 ORM이 지원되나요?
이 기술은 Sequelize, TypeORM, Prisma에 대한 포괄적인 예제와 각 마이그레이션 패턴을 포함합니다.
마이그레이션에 크기 제한이 있나요?
크기 제한은 없지만, 이 기술은 대규모 데이터 마이그레이션에 배치 및 수백만 행에 대한 체크포인트 기반 접근 방식을 권장합니다.
CI 파이프라인에 통합할 수 있나요?
네, 마이그레이션 패턴은 적절한 테스트 및 롤백 절차와 함께 CI/CD 워크플로우에 통합될 수 있습니다.
내 데이터베이스나 시크릿에 접근하나요?
아니요, 이는 데이터 접근, 네트워크 호출 또는 자격 증명 처리 기능이 없는 정적 가이드 콘텐츠입니다.
마이그레이션이 중간에 실패하면 어떻게 되나요?
자동 롤백을 위해 트랜잭션 기반 패턴을 사용하거나, 백업에서 수동 복구를 위해 체크포인트 기반 전략을 사용하세요.
마이그레이션 도구와 어떻게 비교되나요?
Flyway나 Liquibase 같은 도구를 보완하여 자동화된 실행이 아닌 아키텍처 패턴 및 모범 사례를 제공합니다.

개발자 세부 정보

작성자

wshobson

라이선스

MIT

리포지토리

https://github.com/wshobson/agents/tree/main/plugins/framework-migration/skills/database-migration

참조

main

파일 구조

📄 SKILL.md