Transform dense_vector fields to knn_vector
출처: 문서
본문
dense_vector 필드를 knn_vector로 변환하기
Migration Assistant는 메타데이터 마이그레이션 중에 Elasticsearch dense_vector 매핑을 OpenSearch knn_vector 매핑으로 자동 변환할 수 있어요. 대상 매핑은 OpenSearch k-NN 모델에서 유효해야 하고, 마이그레이션 후에는 애플리케이션에서 쿼리 변경이 필요할 수도 있어요.
내장 변환 동작
메타데이터 마이그레이션 경로에서는 다음 작업을 할 수 있어요:
dense_vector를knn_vector로 변환해요.- 벡터 차원과 관련 설정을 변환해요.
- OpenSearch 벡터 검색에 맞게 대상 매핑을 준비해요.
대상에 따라 Serverless-NextGen 전용 조정을 포함한 추가 벡터 호환성 변환이 적용될 수도 있어요.
dense_vector 필드 식별하기
소스에서 dense_vector 필드를 사용하는지 확인하려면 다음 명령어를 실행해 보세요:
console clusters curl source /_mapping
{% include copy.html %}
소스 매핑에 "type":"dense_vector"가 포함되어 있다면, 평가와 파일럿 검증 단계에서 해당 인덱스를 꼼꼼히 살펴보세요.
마이그레이션 후 검증
대상 매핑을 확인해 보세요:
console clusters curl target /your-index/_mapping
workflow show
{% include copy.html %}
또한 대상 클러스터가 사용하려는 벡터 검색 기능을 지원하는지도 확인하세요.
애플리케이션 영향
매핑 마이그레이션이 성공하더라도 쿼리 동작은 여전히 변경이 필요할 수 있어요. 애플리케이션이 현재 Elasticsearch 벡터 쿼리 패턴에 의존하고 있다면 검색 레이어를 꼼꼼히 검증하세요.
추가 고려 사항
다음 경우에는 전환(cutover) 전에 대표적인 쿼리로 파일럿 마이그레이션을 실행해 보세요:
- 대상이 Amazon OpenSearch Serverless NextGen인 경우
- 대상 버전에 벡터 엔진 호환성 제약이 있는 경우
- 애플리케이션이 특정 벡터 쿼리 문법이나 랭킹 동작에 의존하는 경우