Gérer les index vectoriels

Cette page décrit les options permettant de gérer vos index vectoriels. La maintenance des index permet de s'assurer qu'ils s'adaptent aux modifications de données susceptibles d'affecter l'exactitude de vos résultats de recherche. Utilisez les stratégies décrites sur cette page pour éviter la dégradation des performances des requêtes à mesure que votre ensemble de données augmente.

Afficher les métriques de l'index vectoriel

Si votre table est sujette à des mises à jour ou des insertions fréquentes, nous vous recommandons de réindexer régulièrement l'index ScaNN existant afin d'améliorer la précision de la récupération de votre index. Vous pouvez surveiller les métriques d'index pour afficher les modifications apportées aux distributions ou aux mutations de vecteurs depuis la création de l'index, puis réindexer en conséquence.

Pour en savoir plus sur les métriques, consultez Afficher les métriques de l'index vectoriel.

Gérer automatiquement les index

Vous pouvez utiliser l'indicateur de base de données scann.enable_preview_features (GUC) avec le paramètre auto_maintenance au niveau de l'index lors de la création d'un indice ScaNN. L'utilisation conjointe de ces paramètres permet à AlloyDB de gérer l'index de manière incrémentielle de sorte que, lorsque votre ensemble de données augmente, il divise les grandes partitions d'écarts. En divisant les partitions, AlloyDB tente de fournir de meilleurs RPS et des résultats de recherche plus précis.

Toutes les modifications apportées à l'index en raison de la maintenance automatique sont permanentes jusqu'à ce qu'AlloyDB mette à jour l'index à nouveau.

Pour permettre à AlloyDB de gérer automatiquement un indice, activez l'indicateur scann.enable_preview_features:

gcloud alloydb instances update INSTANCE_ID \
     --database-flags scann.enable_preview_features=on \
     --region=REGION_ID \
     --cluster=CLUSTER_ID \
     --project=PROJECT_ID

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de l'instance
  • REGION_ID: région où se trouve l'instance (par exemple, us-central1).
  • CLUSTER_ID: ID du cluster dans lequel se trouve l'instance.
  • PROJECT_ID: ID du projet dans lequel le cluster est placé.

Après avoir activé l'indicateur scann.enable_preview_features, vous pouvez activer la maintenance automatique des index ou la fonction scann_index_maintenance pour appeler manuellement la maintenance.

Activer la maintenance automatique lors de la création de l'index

Pour créer un indice ScaNN avec la maintenance automatique activée, exécutez l'exemple de commande suivant:

CREATE INDEX INDEX_NAME ON TABLE
  USING scann (EMBEDDING_COLUMN DISTANCE_FUNCTION)
  WITH (num_leaves=NUM_LEAVES_VALUE, auto_maintenance=on);

Remplacez les éléments suivants :

  • INDEX_NAME: nom de l'index que vous souhaitez créer (par exemple, my-scann-index) Les noms d'index sont partagés dans votre base de données. Assurez-vous que chaque nom d'index est unique pour chaque table de votre base de données.

  • TABLE: table à laquelle ajouter l'index.

  • EMBEDDING_COLUMN: colonne qui stocke les données vector.

  • DISTANCE_FUNCTION: fonction de distance à utiliser avec cet index. Choisissez l'une des options suivantes :

    • Distance L2:l2

    • Produit scalaire: dot_product

    • Distance de cosinus:cosine

  • NUM_LEAVES_VALUE: nombre de partitions à appliquer à cet index. Définissez cette valeur sur une valeur comprise entre 1 et 1048576. Pour en savoir plus sur la détermination de cette valeur, consultez Configurer un indice ScaNN.

Gérer les feuilles pour rechercher automatiquement les partitions fractionnées

Si vous avez activé la maintenance automatique des index, AlloyDB divise automatiquement les partitions lorsque le seuil num_leaves est atteint. À mesure que le nombre de partitions augmente en raison de ces divisions, vous devez ajuster le nombre de feuilles à rechercher pour maintenir des performances optimales.

Pour gérer le nombre de feuilles à rechercher automatiquement, utilisez pct_leaves_to_search. Ce paramètre vous permet de spécifier un pourcentage du nombre de partitions à rechercher. Si vous prévoyez que votre ensemble de données va considérablement augmenter, commencez par définir la valeur pct_leaves_to_search sur 1. Ce paramètre est désactivé par défaut.

Définissez cette valeur sur le pourcentage du nombre actuel de partitions. Par exemple, pour rechercher 1 % du nombre actuel de partitions, définissez cette valeur sur 1.

Vous pouvez définir ce paramètre sur n'importe quelle valeur comprise entre 0 et 100. La valeur par défaut est 0, ce qui désactive ce paramètre et utilise scann.num_leaves_to_search pour calculer le nombre de feuilles à rechercher.

Pour définir l'indicateur pct_leaves_to_search sur votre base de données, exécutez la commande suivante:

ALTER DATABASE DATABASE_NAME SET scann.pct_leaves_to_search = PERCENTAGE_LEAVES_TO_SEARCH;

Remplacez les éléments suivants :

  • DATABASE_NAME: nom de la base de données.
  • PERCENTAGE_LEAVES_TO_SEARCH: pourcentage de num_leaves à rechercher.

Invoquer manuellement la maintenance

Si vous souhaitez appeler la maintenance d'un indice particulier à la demande, exécutez la commande suivante:

SELECT scann_index_maintenance('INDEX_NAME');

Recompiler manuellement votre index

Vous pouvez recréer manuellement votre index si vous souhaitez le recréer avec les configurations que vous avez spécifiées lors de sa création.

Pour reconstruire manuellement votre index, exécutez la commande suivante:

REINDEX INDEX CONCURRENTLY INDEX_NAME;

Remplacez INDEX_NAME par le nom de l'index que vous souhaitez reconstruire (par exemple, my-scann-index). Les noms d'index sont partagés dans votre base de données. Assurez-vous que chaque nom d'index est unique pour chaque table de votre base de données.

Pour en savoir plus sur le réindexage dans PostgreSQL, consultez REINDEX.

Étape suivante