Vektoreinbettungen für Ihre Instanz 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 Vektor-Embeddings. Alle Versionen von MySQL 8.0.36 und höher 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.

Datenbankflag für Vektoreinbettungen aktivieren

Wenn Sie die Unterstützung für Vektor-Embeddings 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 für Vektor-Embeddings aktivieren möchten.
  • FLAGS: Konfigurieren Sie das folgende MySQL-Flag auf Ihrer 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 der 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 (indem Sie es 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 Vektor-Embeddings auf Ihrer Instanz deaktivieren können, müssen Sie alle Vektorindexe auf der Instanz explizit löschen. Informationen zum Abrufen einer Liste der Vektorindexe in der Instanz finden Sie unter Vektorindexe beobachten.

Wenn Sie die Unterstützung für Vektor-Embeddings deaktivieren, können Sie keine neuen Vektor-Embedding-Spalten und Vektorindizes mehr 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 Vektor-Embeddings deaktivieren möchten.

Nächste Schritte