ERD 가져오기·내보내기와 변경 관리
기존 데이터베이스 구조를 ERD로 가져오거나, 검토한 모델을 명세와 변경 SQL로 전달할 때 사용합니다.
가져오기 전에
가져올 스키마의 출처와 범위를 확인합니다.
- 운영 환경의 비밀값이나 실제 데이터가 포함되지 않았는가
- 필요한 스키마만 선택했는가
- 현재 프로젝트의 DB 종류와 버전이 맞는가
- 기존 ERD를 덮거나 중복 생성하지 않는가
가져오기 형식과 옵션은 AiNecto 웹에서 확인한 뒤 실행합니다. 스키마 가져오기는 웹에서 진행하며 Agent에게 직접 실행을 요청하지 않습니다.
가져온 결과 검토하기
가져오기가 끝나면 다음을 확인하세요.
- 테이블과 컬럼 수가 예상과 맞는가
- 기본 키와 외래 키가 유지되었는가
- 데이터 타입과 기본값이 변환 과정에서 달라지지 않았는가
- Enum, 인덱스와 관계가 빠지지 않았는가
- 이름 충돌이나 중복 테이블이 없는가
가져온 구조를 즉시 현재 기준으로 확정하지 말고 프로젝트 문서와 실제 시스템을 비교합니다.
ERD 내보내기
내보내기의 목적을 먼저 정합니다.
- 다른 도구에서 사용할 스키마
- 팀 검토를 위한 이미지나 문서
- 구현을 위한 SQL
- 현재 구조를 설명하는 DB 명세서
AiNecto 웹에서 제공하는 형식으로 내보내고, 결과를 다시 열어 누락과 깨진 항목이 없는지 확인하세요. 내보내기는 웹에서 진행합니다.
DB 명세서 Export
DB 명세서는 테이블, 컬럼, 타입, 제약과 설명을 사람이 검토할 수 있는 형태로 전달합니다.
내보내기 전에 테이블과 컬럼 설명, 관계와 용어가 최신인지 확인합니다. 명세서를 생성한 뒤 프로젝트 기준과 다른 부분이 없는지 검토합니다.
Migration SQL
Migration SQL은 두 상태의 차이를 실제 변경 작업으로 옮길 때 사용합니다.
실행 전에 다음을 확인하세요.
- 기준 버전과 대상 버전이 올바른가
- 데이터 손실 가능성이 있는 변경이 있는가
- 컬럼 삭제와 타입 변경에 별도 이전 작업이 필요한가
- 인덱스와 제약 변경이 서비스에 미치는 영향은 무엇인가
- 되돌릴 방법과 백업이 준비되어 있는가
Migration SQL 생성이 현재 화면에서 제공되는 범위인지 먼저 확인합니다. 생성된 SQL은 초안입니다. 운영 데이터베이스에 적용하기 전에 개발·검증 환경에서 검토하고 테스트하세요.
변경 결과 남기기
ERD와 실제 시스템 사이에 차이가 생기지 않도록 변경 이유와 적용 결과를 프로젝트에 남깁니다.
이번 ERD 변경에서 확정된 결정, 위험과 후속 작업을 프로젝트 기준 문서에 반영해줘.
ERD, OpenAPI와 구현 결과가 함께 바뀌었다면 관련 문서의 현재 상태도 같이 갱신합니다.
다음 단계
전문 산출물의 변경을 Markdown 기준 문서와 Kanban 후속 업무에 반영하세요.