RAG 마이그레이션을 디버깅할 때 먼저 보는 것

RAG 모델 변경은 단순한 설정 변경처럼 보이지만, 실제로는 기존 문서와 새 임베딩 컬렉션 사이의 데이터 이동 문제입니다.

먼저 확인하는 세 가지

• 현재 마이그레이션 상태가 명시적으로 저장되는지 확인한다.
• 삭제된 문서와 활성 문서를 같은 카운터로 계산하지 않는다.
• 적용 단계 전에 재시도 가능한 중간 상태를 만든다.

내가 선호하는 흐름

상태를 시간값으로 추론하지 않고, 사용자가 볼 수 있는 진행 상태로 저장합니다. 그래야 실패 후 재시도하거나 정리할 때 데이터 손실 가능성을 줄일 수 있습니다.

type MigrationStatus = 'idle' | 'preparing' | 'ready' | 'applying' | 'done' | 'failed';

좋은 마이그레이션 코드는 빠른 코드가 아니라, 실패했을 때 어디서 멈췄는지 설명할 수 있는 코드입니다.