Vektorsuche aktivieren und deaktivieren

In diesem Abschnitt wird beschrieben, wie Sie Ihre Cloud SQL-Instanz so konfigurieren, dass das Speichern, Indexieren und Abfragen von Vektoreinbettungen unterstützt wird.

Sowohl Cloud SQL Enterprise- als auch Cloud SQL Enterprise Plus-Instanzen unterstützen Vektoreinbettungen. Alle Versionen von MySQL 8.0.36 und höher werden unterstützt.

Hinweis

Achten Sie darauf, dass Sie für Ihr Nutzerkonto die Rollen „Cloud SQL-Administrator“ und „Compute-Betrachter“ haben.

Weitere Informationen finden Sie unter Rollen und -Berechtigungen.

Vektorsuche mit dem Datenbank-Flag aktivieren

Wenn Sie die Unterstützung für das Speichern von Vektoreinbettungen in Ihrer Datenbank in Cloud SQL for MySQL 8.4 und früher aktivieren möchten, aktivieren Sie das MySQL-Datenbank-Flag cloudsql_vector.

Wenn Sie Cloud SQL for MySQL 9.7 oder höher verwenden, aktivieren Sie das cloudsql_vector MySQL-Datenbank-Flag, um die Unterstützung für das Erstellen von Vektorindexen und für die Durchführung der ANN-Suche hinzuzufügen.

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=FLAGS

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz, für die Sie die Vektorsuche aktivieren möchten.

  • FLAGS: Konfigurieren Sie das folgende MySQL-Flag für Ihre Instanz:

    • cloudsql_vector: Setzen Sie dieses Flag auf on, um die Cloud SQL-Vektorsuche zu aktivieren. Dieses Flag ist standardmäßig deaktiviert. Wenn Sie das Flag konfigurieren, sieht der Befehl so aus:

      gcloud sql instances patch my-instance \
--database-flags=cloudsql_vector=on

      Das Flag cloudsql_vector ist statisch. Nachdem Sie die Instanz mit dem Flag aktualisiert haben (indem Sie es aktivieren oder deaktivieren), wird die Instanz automatisch neu gestartet, damit die Konfigurationsänderungen wirksam werden.

Weitere Informationen zum Konfigurieren von Datenbank-Flags für MySQL finden Sie unter Datenbank-Flags konfigurieren.

Vektoreinbettungen deaktivieren

Bevor Sie Vektoreinbettungen für Ihre Instanz deaktivieren, müssen Sie alle Vektorindexe in der Instanz explizit löschen. Informationen zum Abrufen einer Liste von Vektorindexen in der Instanz finden Sie unter Vektorindexe beobachten.

Wenn Sie die Unterstützung für Vektoreinbettungen deaktivieren, können Sie keine neuen Spalten für Vektoreinbettungen erstellen, wenn Sie MySQL 8.4 oder früher verwenden. Wenn Sie MySQL 9.7 oder höher verwenden, können Sie keine Vektorindexe erstellen. Außerdem können Sie die Funktion approx_distance nicht für Vektorsuchen verwenden. Wenn Sie die Unterstützung für Vektoreinbettungen deaktivieren möchten, setzen Sie das Flag cloudsql_vector auf off. Nachdem Sie dieses statische Flag konfiguriert haben, wird die Instanz automatisch neu gestartet, damit die Konfigurationsänderung wirksam wird.

Wenn Sie die Unterstützung für Vektoreinbettungen deaktivieren möchten, setzen Sie das Flag cloudsql_vector auf off.

Beispiel:

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=cloudsql_vector=off

Ersetzen Sie INSTANCE_NAME durch den Namen der Instanz, für die Sie die Unterstützung für Vektoreinbettungen deaktivieren.

Nächste Schritte