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 la section Rôles et autorisations.

Activer l'indicateur 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'indicateur MySQL suivant sur votre instance:

    • cloudsql_vector: définissez cette option sur on pour activer le stockage des représentations vectorielles continues et la recherche de similarité vectorielle. Cet indicateur est désactivé par défaut. Lorsque vous configurez l'indicateur, votre commande ressemble à ceci:

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

      L'indicateur cloudsql_vector est statique. Une fois l'instance mise à jour avec l'indicateur (en l'activant ou en le 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 représentations vectorielles continues 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 la section Surveiller les index de vecteurs.

Si vous désactivez la compatibilité avec les embeddings vectoriels, vous ne pouvez 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'indicateur 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.

Étape suivante