Vektorsuche aktivieren und deaktivieren

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

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

Sie benötigen für Ihr Nutzerkonto die Rollen „Cloud SQL-Administrator“ und „Compute-Betrachter“.

Weitere Informationen finden Sie unter Rollen und Berechtigungen.

Vektorsuchfunktion 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 MySQL-Datenbank-Flag cloudsql_vector, um die Unterstützung für das Erstellen von Vektorindexen und für die 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 Vektorsuchfunktion aktivieren möchten.

  • FLAGS: Konfigurieren Sie das folgende MySQL-Flag auf Ihrer 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 Ihr Befehl in etwa 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 (durch 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 auf Ihrer Instanz deaktivieren können, müssen Sie alle Vektorindexe auf der Instanz explizit löschen. Informationen zum Aufrufen einer Liste von Vektorindexen auf der Instanz finden Sie unter Vektorindexe überwachen.

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 niedriger 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 von Vektoreinbettungen deaktivieren möchten.

Nächste Schritte