Spanner ベクトル検索のトラブルシューティング

このページでは、Spanner ベクトル検索の使用中に問題が発生した場合に役立つヒントについて説明します。

「ベクトル インデックスが見つかりません」というエラーでクエリが失敗する

この問題は、ベクトル インデックスを使用するクエリが実行されたときに、クエリ オプティマイザーが適切なインデックスを見つけられない場合に発生します。

この問題を解決するには、次の一般的な原因を確認してください。

  • 距離のタイプの不一致: インデックスで定義されている距離のタイプが、クエリで使用されている距離のタイプと一致していることを確認します。
  • インデックスのバックフィル: インデックスのバックフィル プロセスが完了していることを確認します。バックフィルが完了するまで、ベクトル インデックスはクエリに使用できません。詳細については、長時間実行オペレーションの管理とモニタリングをご覧ください。
  • IS NOT NULL フィルタがない: クエリに、エンベディング列の IS NOT NULL フィルタが含まれていることを確認します。このフィルタは、クエリ オプティマイザーがインデックスを考慮するために、ベクトル インデックス定義のフィルタと一致する必要があります。

「近似距離関数の使用はサポートされていません」というエラーでクエリが失敗する

すべてのクエリ パターンが ANN 検索をサポートしているわけではありません。使用方法と制限事項の詳細については、近似距離関数のドキュメントをご覧ください。

クエリでベクトル インデックスが使用されていることを確認する

クエリがベクトル インデックスを使用しているかどうかは、クエリ実行プランを確認することで確認できます。

クエリ実行プランで、ベクトル インデックスを参照する Scan ノードを探します。

次のステップ