검색 분석기나 문서 구조를 바꾸면 전체 색인을 다시 만들어야 할 수 있습니다. 운영 색인을 바로 수정하는 대신 새 색인을 옆에 만들고 검증한 뒤 전환하는 방식이 유용합니다. 하지만 데이터가 계속 바뀌는 서비스에서는 복사 완료만으로 두 색인이 같아지지 않습니다. 무중단 전환의 핵심은 새 저장소보다 기준 시점과 변경 이력입니다.
색인 이름과 서비스 진입점을 분리한다
애플리케이션이 물리적인 색인 이름을 직접 사용하면 교체 때마다 여러 소비자를 함께 바꿔야 합니다. 제품이 지원하는 별칭 같은 논리적 진입점을 두면 읽기 대상을 중앙에서 전환할 수 있습니다. 관리 도구와 배치 작업까지 같은 진입점을 사용하는지 확인합니다.
별칭의 원자적 교체 기능이 있어도 데이터 복사와 애플리케이션 배포까지 자동으로 원자화되는 것은 아닙니다. 쓰기 대상, 읽기 대상, 구형 필드에 의존하는 코드의 호환성을 따로 점검해야 합니다. 제품별 별칭 동작과 제한도 확인합니다.
초기 복사와 변경분 사이에 빈틈을 만들지 않는다
원본의 일관된 스냅샷이나 재현 가능한 기준 위치에서 초기 데이터를 읽습니다. 그 이후의 삽입·수정·삭제를 변경 로그로 따라가며 새 색인을 최신 상태에 가깝게 만듭니다. 기준 위치 없이 복사한 다음 나중부터 변경을 받으면 중간 사건이 빠질 수 있습니다.
변경 이벤트를 중복 수신해도 같은 결과가 되도록 문서 키와 버전을 활용합니다. 늦게 도착한 오래된 수정이 더 최신 문서를 덮지 않도록 순서 정책을 정합니다. 새 색인에만 반영된 문서가 초기 복사에서 다시 덮이는 경우도 테스트해야 합니다.
문서 개수만 같아서는 부족하다
두 색인의 문서 수가 같아도 서로 다른 문서가 들어 있거나 일부 필드가 잘못 변환됐을 수 있습니다. 대표 키의 존재, 주요 필드, 집계, 삭제 반영, 최근 수정 시각을 확인합니다. 새 분석기에서는 같은 검색어의 결과가 달라질 수 있으므로 품질 평가도 필요합니다.
특히 조직과 권한 필터를 검증합니다. 검색 정확도가 좋아졌더라도 다른 고객 문서가 노출되면 전환할 수 없습니다. 필터 누락, 비공개 전환, 권한 회수, 문서 삭제를 대표 시나리오에 넣고 결과 본문과 자동완성까지 검사합니다.
가상 사례: 전환 직전에 삭제된 문서
초기 복사에는 있던 문서가 운영 원본에서 삭제됐다고 가정해 봅시다. 새 색인이 수정 이벤트만 받고 삭제를 받지 않으면 전환 후 문서가 다시 나타납니다. 이 문제는 문서 수의 작은 차이로 보일 수 있지만 공개 범위와 직결됩니다.
삭제를 명시적인 변경으로 전달하고 새 색인이 해당 위치까지 처리했는지 확인합니다. 전환 직전에는 처리 지연뿐 아니라 실패·보류 이벤트도 살펴봅니다. 최신 이벤트 시각 하나만 보고 모든 이전 변경이 적용됐다고 단정하지 않습니다.
되돌리기는 이전 색인의 신선도에 달렸다
전환 후 이전 색인에 변경 반영을 중단했다면 곧바로 되돌리는 순간 최근 문서가 사라지거나 오래된 권한이 살아날 수 있습니다. 일정 기간 양쪽을 동기화하거나 되돌리기 전에 따라잡는 절차가 필요합니다. 오래된 색인이 남아 있다는 사실만으로 복구가 준비된 것은 아닙니다.
스키마 변경으로 이전 색인이 새 데이터를 표현하지 못한다면 단순한 별칭 복귀는 불가능할 수 있습니다. 호환 가능한 변경 범위, 롤백 가능 시간, 필요한 재처리 절차를 정합니다. 복구 목표를 충족하지 못하면 이전 버전 유지 대신 수정 후 재전환 전략이 필요합니다.
작게 전환하고 관찰한다
실제 사용자 요청을 새 색인에도 복제해 결과를 비교하되 응답은 기존 색인에서 제공하는 방식으로 사전 검증할 수 있습니다. 민감한 쿼리의 로그와 복제 범위는 통제해야 합니다. 전환 판단에는 지연시간뿐 아니라 빈 결과와 오류, 주요 검색 품질을 포함합니다.
전환 담당자와 중단 기준을 정하고 별칭 상태를 확인한 뒤 모니터링합니다. 기존 색인의 삭제는 보존 기간과 복구 검증이 끝난 이후 별도 작업으로 진행합니다. 안정적인 검색 교체는 빠른 스위치 하나가 아니라 데이터와 권한을 이어 주는 과정입니다.
실무 체크리스트
- 초기 스냅샷과 변경 로그의 기준 위치가 연결되는가
- 수정뿐 아니라 삭제·권한 변경도 새 색인에 반영됐는가
- 이전 색인으로 돌아가도 최신 데이터와 권한이 유지되는가
참고 자료: Elastic의 aliases 공식 문서. 공식 문서는 Elasticsearch 별칭 관리와 교체 기능을 설명합니다. 스냅샷·변경 로그 동기화와 검증 절차는 별칭 자체가 제공하는 보장이 아니라 별도로 구현해야 할 설계입니다.
본문 이미지는 이해를 돕기 위해 생성한 개념 삽화이며 실제 측정 자료나 고객 현장 사진이 아닙니다.
#검색색인 #Elasticsearch #무중단전환 #블루그린 #데이터동기화 #검색품질 #데이터엔지니어링 #권한필터 #롤백 #색인마이그레이션
