排解 Spanner 向量搜尋問題

本頁面提供實用提示，協助您解決使用 Spanner 向量搜尋時遇到的問題。

查詢失敗，並顯示「找不到向量索引」錯誤

當您預期查詢會使用向量索引，但查詢最佳化工具找不到合適的索引時，就會發生這個問題。

如要解決這個問題，請檢查下列常見原因：

  • 距離類型不符：確認索引中定義的距離類型與查詢中使用的距離類型相符。
  • 索引補充作業：確認索引補充作業是否完成。回填完成前，向量索引無法用於查詢。詳情請參閱「管理及監控長時間執行的作業」。
  • 缺少 IS NOT NULL 篩選器：請確認查詢包含嵌入資料欄的 IS NOT NULL 篩選器。這個篩選條件必須與查詢最佳化工具的向量索引定義中的篩選條件相符，才能考慮索引。

查詢失敗，並顯示「unsupported use of an approximate distance function」(不支援使用近似距離函式) 錯誤

並非所有查詢模式都支援 ANN 搜尋。如要瞭解詳細的使用資訊和限制，請參閱概略距離函式說明文件：

確認查詢是否使用向量索引

您可以查看查詢執行計畫，確認查詢是否使用向量索引。

在查詢執行計畫中，尋找參照向量索引的 Scan 節點。

後續步驟