Vektoreinbettungen für Ihre Instanz aktivieren und deaktivieren

In diesem Abschnitt wird beschrieben, wie Sie Ihre Cloud SQL-Instanz für die Speicherung, Indexierung und Abfrage von Vektoreinbettungen konfigurieren.

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

Hinweise

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

Weitere Informationen finden Sie unter Rollen und Berechtigungen.

Datenbankflagge für Vektoreinbettungen aktivieren

Wenn Sie die Unterstützung für Vektoreinbettungen aktivieren möchten, müssen Sie die MySQL-Datenbank-Flags aktivieren.

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

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz, für die Sie die Unterstützung von Vektoreinbettungen aktivieren möchten.

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

    • cloudsql_vector: Legen Sie dieses Flag auf on fest, um die Speicherung von Vektoreinbettungen und die Unterstützung der Vektorähnlichkeitssuche 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 sie 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 dazu, wie Sie eine Liste von Vektorindexen in der Instanz aufrufen, finden Sie unter Vektorindexe überwachen.

Wenn Sie die Unterstützung von Vektoreinbettungen deaktivieren, können Sie keine neuen Spalten für Vektoreinbettungen und Vektorindexe erstellen. Außerdem können Sie die approx_distance-Funktion 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