Fehlerbehebung bei der Spanner-Vektorsuche

Auf dieser Seite finden Sie Tipps, die Ihnen helfen können, wenn Probleme bei der Verwendung der Spanner-Vektorsuche auftreten.

Abfrage schlägt mit dem Fehler „no vector index found“ (kein Vektorindex gefunden) fehl

Dieses Problem tritt auf, wenn eine Abfrage ausgeführt wird, für die Sie einen Vektorindex erwarten, der Query Optimizer jedoch keinen geeigneten Index finden kann.

Prüfen Sie, ob eine der folgenden häufigen Ursachen vorliegt, um das Problem zu beheben:

  • Falscher Distanztyp: Prüfen Sie, ob der im Index definierte Distanztyp mit dem in der Abfrage verwendeten Distanztyp übereinstimmt.
  • Index-Backfill: Prüfen Sie, ob der Index-Backfill abgeschlossen ist. Vektorindexe sind erst dann für Abfragen verfügbar, wenn das Backfilling abgeschlossen ist. Weitere Informationen finden Sie unter Vorgänge mit langer Ausführungszeit verwalten und beobachten.
  • Fehlender IS NOT NULL-Filter: Achten Sie darauf, dass Ihre Abfrage einen IS NOT NULL-Filter für die Einbettungsspalte enthält. Dieser Filter muss mit dem Filter in der Vektorindexdefinition übereinstimmen, damit der Query-Optimierer den Index berücksichtigt.

Eine Abfrage schlägt mit dem Fehler „unsupported use of an approximate distance function“ (nicht unterstützte Verwendung einer ungefähren Distanzfunktion) fehl.

Nicht alle Abfragemuster unterstützen die ANN-Suche. Detaillierte Informationen zur Verwendung und zu Einschränkungen finden Sie in der Dokumentation zur Funktion für die ungefähre Entfernung:

Prüfen, ob für eine Anfrage ein Vektorindex verwendet wird

Sie können prüfen, ob eine Abfrage einen Vektorindex verwendet, indem Sie den Abfrageausführungsplan prüfen.

Suchen Sie im Abfrageausführungsplan nach Scan-Knoten, die auf Ihren Vektorindex verweisen.

Nächste Schritte