Resolver problemas da pesquisa vetorial do Spanner

Esta página descreve dicas que podem ajudar você se encontrar problemas ao usar a pesquisa vetorial do Spanner.

A consulta falha com um erro "no vector index found"

Esse problema ocorre quando uma consulta que você espera usar um índice vetorial é executada, mas o otimizador de consultas não consegue encontrar um índice adequado.

Para resolver esse problema, verifique as seguintes causas comuns:

  • Incompatibilidade do tipo de distância: verifique se o tipo de distância definido no índice corresponde ao tipo de distância usado na consulta.
  • Preenchimento do índice: confirme se o processo de preenchimento do índice foi concluído. Os índices vetoriais não estão disponíveis para consultas até que o preenchimento seja concluído. Para mais informações, consulte Gerenciar e observar operações de longa duração.
  • Filtro IS NOT NULL ausente: verifique se a consulta inclui um IS NOT NULL na coluna de incorporação. Esse filtro precisa corresponder ao filtro na definição do índice vetorial para que o otimizador de consultas considere o índice.

Uma consulta falha com um erro "unsupported use of an approximate distance function"

Nem todos os padrões de consulta oferecem suporte à pesquisa de ANN. Consulte a documentação da função de distância aproximada para informações detalhadas sobre o uso e as limitações:

Verificar se uma consulta usa um índice vetorial

Você pode verificar se uma consulta usa um índice vetorial conferindo o plano de execução da consulta.

No plano de execução da consulta, procure nós Scan que referenciam o índice vetorial.

A seguir