Activer et désactiver la recherche vectorielle

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 la fonctionnalité de recherche vectorielle à l'aide de l'option de base de données

Pour activer la compatibilité avec le stockage des embeddings vectoriels dans votre base de données dans Cloud SQL pour MySQL 8.4 et versions antérieures, activez l'option de base de données MySQL cloudsql_vector.

Si vous utilisez Cloud SQL pour MySQL 9.7 ou une version ultérieure, activez l'option de base de données MySQL cloudsql_vector pour ajouter la compatibilité avec la création d'index vectoriels et l'exécution de recherches ANN

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 fonctionnalité de recherche vectorielle.

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

    • cloudsql_vector: définissez cette option sur on pour activer la fonctionnalité de recherche vectorielle Cloud SQL. Cette option est désactivée par défaut. Lorsque vous configurez l'option, 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 de l'instance. Pour savoir comment trouver la liste des index vectoriels sur l'instance, consultez Surveiller les index vectoriels.

La désactivation de la compatibilité avec les embeddings vectoriels vous empêche de créer des colonnes d'embedding vectoriel si vous utilisez MySQL 8.4 ou une version antérieure. Si vous utilisez MySQL 9.7 ou une version ultérieure, vous ne pouvez pas créer d'index vectoriels. Vous ne pouvez pas non plus 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.

Étape suivante