排查 Spanner 向量搜索问题

本页面介绍了在您遇到 Spanner 向量搜索使用问题时可能有帮助的提示。

查询失败，并显示“未找到向量索引”错误

当您预期会使用向量索引的查询运行时，如果查询优化器找不到合适的索引，就会出现此问题。

如需解决此问题，请检查以下常见原因：

  • 距离类型不匹配：验证索引上定义的距离类型是否与查询中使用的距离类型一致。
  • 索引回填：确认索引回填过程已完成。在回填完成之前，向量索引无法用于查询。如需了解详情，请参阅管理和观察长时间运行的操作。
  • 缺少 IS NOT NULL 过滤条件：确保您的查询在嵌入列中包含 IS NOT NULL 过滤条件。此过滤条件必须与向量索引定义中的过滤条件相匹配，查询优化器才会考虑该索引。

查询失败，并显示“不支持使用近似距离函数”错误

并非所有查询模式都支持 ANN 搜索。如需详细了解使用信息和限制，请查看近似距离函数文档：

验证查询是否使用了向量索引

您可以通过检查查询执行计划来验证查询是否使用了向量索引。

在查询执行计划中，查找引用向量索引的 Scan 节点。

后续步骤