Spanner 벡터 검색 문제 해결

이 페이지에서는 Spanner 벡터 검색을 사용하는 중에 발생하는 문제를 해결하는 데 도움이 되는 팁을 설명합니다.

'벡터 색인을 찾을 수 없음' 오류로 쿼리가 실패함

벡터 색인을 사용할 것으로 예상되는 쿼리가 실행되지만 쿼리 옵티마이저가 적합한 색인을 찾을 수 없는 경우 이 문제가 발생합니다.

이 문제를 해결하려면 다음과 같은 일반적인 원인을 확인하세요.

  • 거리 유형 불일치: 색인에 정의된 거리 유형이 쿼리에 사용된 거리 유형과 일치하는지 확인합니다.
  • 색인 백필: 색인 백필 프로세스가 완료되었는지 확인합니다. 백필이 완료될 때까지는 쿼리에 벡터 색인을 사용할 수 없습니다. 자세한 내용은 장기 실행 작업 관리 및 관찰을 참고하세요.
  • IS NOT NULL 필터 누락: 쿼리에 임베딩 열에 대한 IS NOT NULL 필터가 포함되어 있는지 확인합니다. 쿼리 옵티마이저가 색인을 고려하려면 이 필터가 벡터 색인 정의의 필터와 일치해야 합니다.

'근사 거리 함수를 지원하지 않는 사용' 오류로 쿼리가 실패함

일부 쿼리 패턴은 ANN 검색을 지원하지 않습니다. 자세한 사용 정보 및 제한사항은 근사 거리 함수 문서를 검토하세요.

쿼리에서 벡터 색인을 사용하는지 확인

쿼리 실행 계획을 확인하여 쿼리에서 벡터 색인을 사용하는지 확인할 수 있습니다.

쿼리 실행 계획에서 벡터 색인을 참조하는 Scan 노드를 찾습니다.

다음 단계