Activer et désactiver les embeddings vectoriels sur votre instance

Cette section explique comment configurer votre instance Cloud SQL pour qu'elle soit compatible avec le stockage, l'indexation et l'interrogation des embeddings vectoriels.

Les instances Cloud SQL Enterprise et Cloud SQL Enterprise Plus sont toutes deux compatibles avec les embeddings vectoriels. Toutes les versions de MySQL 8.0.36 et ultérieures sont compatibles.

Avant de commencer

Assurez-vous de disposer des rôles d'administrateur Cloud SQL et de lecteur de Compute sur votre compte utilisateur.

Pour en savoir plus, consultez Rôles et autorisations.

Activer le flag de base de données pour les embeddings vectoriels

Pour activer la compatibilité avec les embeddings vectoriels, vous devez activer les options de base de données MySQL.

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance sur laquelle vous souhaitez activer la prise en charge des représentations vectorielles continues.

  • FLAGS : configurez l'option MySQL suivante sur votre instance :

    • cloudsql_vector : définissez cette option sur on pour activer le stockage des embeddings vectoriels et la recherche de similarité vectorielle. Cette option est désactivée par défaut. Lorsque vous configurez l'indicateur, votre commande ressemble à ce qui suit :

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

      L'option cloudsql_vector est statique. Une fois l'instance mise à jour avec l'option (en l'activant ou en la désactivant), celle-ci redémarre automatiquement pour que les modifications de configuration entrent en vigueur.

Pour en savoir plus sur la configuration des options de base de données pour MySQL, consultez la page Configurer des options de base de données.

Désactiver les embeddings vectoriels

Avant de désactiver les embeddings vectoriels sur votre instance, vous devez supprimer explicitement tous les index vectoriels sur l'instance. Pour savoir comment trouver la liste des index de vecteurs sur l'instance, consultez Surveiller les index de vecteurs.

Si vous désactivez la compatibilité avec les embeddings vectoriels, vous ne pourrez pas créer de colonnes d'embedding ni d'index vectoriels. Cela vous empêche également d'utiliser la fonction approx_distance pour les recherches vectorielles. Pour désactiver la compatibilité avec les embeddings vectoriels, définissez l'option cloudsql_vector sur off. Une fois que vous avez configuré cette option statique, l'instance redémarre automatiquement pour que la modification de configuration entre en vigueur.

Pour désactiver la compatibilité avec les embeddings vectoriels, définissez l'option cloudsql_vector sur off.

Exemple :

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

Remplacez INSTANCE_NAME par le nom de l'instance sur laquelle vous désactivez la compatibilité avec les embeddings vectoriels.

Étapes suivantes