:Gérer les fichiers de dictionnaire de synonymes

Notes d'utilisation et bonnes pratiques

Consultez ces points essentiels avant de charger ou de gérer des fichiers de dictionnaire de synonymes.

État du cluster et impact du redémarrage

• Intégrité du cluster : Avant le chargement, vérifiez que votre cluster Elasticsearch est sain.

• Redémarrage automatique : Le chargement d'un nouveau fichier de dictionnaire de synonymes déclenche un redémarrage progressif automatique de votre cluster. Pendant ce redémarrage, le système met à jour les dictionnaires de synonymes sur tous les nœuds.

• Durée du redémarrage : La durée nécessaire pour que le redémarrage et les mises à jour du dictionnaire prennent effet dépend des spécifications de votre cluster, du volume de données et de la charge actuelle.

• Risque d'interruption de service :

  • Faible impact (Recommandé) : Si vos index disposent de shards répliques et que la charge du cluster est normale (CPU ~60 %, heap ~50 %, NodeLoad_1m < nombre de vCPU), votre cluster peut généralement continuer à fournir des services pendant le redémarrage progressif.

  • Impact élevé (À éviter) : Si vos index ne disposent pas de shards répliques, ou si le cluster subit une charge excessivement élevée avec de nombreuses opérations d'écriture ou de requête, l'accès au cluster peut expirer pendant le redémarrage. Implémentez un mécanisme de nouvelle tentative d'accès dans vos applications clientes afin de minimiser l'impact sur l'activité.

• Planification : Nous vous recommandons vivement de charger les fichiers de dictionnaire de synonymes pendant les heures creuses, en raison du redémarrage du cluster et de la consommation potentielle de ressources.

Impact sur les index existants

• Nouveaux fichiers de dictionnaire et index existants : Un fichier de dictionnaire de synonymes nouvellement chargé ou mis à jour ne prend pas automatiquement effet pour les index existants. En effet, les index existants ne rechargent pas automatiquement les configurations de l'analyseur.

• Application aux index existants : Pour appliquer le nouveau dictionnaire aux index existants, choisissez l'une des méthodes suivantes :

  • Réindexer les données : Réindexez les données de ces index après la mise à jour du dictionnaire de synonymes. Cette opération n'interrompt généralement pas les services.

  • Rouvrir les index : Fermez puis rouvrez les index concernés. Cette opération interrompra les services pour ces index.

    ---index_name specifies the name of an index.
    POST <index_name>/_close
    POST <index_name>/_open

Format et règles du fichier de dictionnaire de synonymes

• Type de fichier : Un fichier de dictionnaire de synonymes doit être un fichier TXT brut encodé en UTF-8.

• Contenu : Chaque ligne du fichier ne doit contenir qu'une seule expression de synonyme.

• Types de règles : Les expressions de synonymes prennent en charge les règles Solr et les règles WordNet.

• Exemples de formats :

  ipod, i-pod, i pod
  computer, pc, laptop

Conflits et conventions de nommage

• Conflits avec les mots vides : La liste des mots vides de votre cluster Elasticsearch ne doit contenir aucun mot clé spécifié dans votre fichier de dictionnaire de synonymes. Des conflits entraîneront des erreurs dans les journaux du cluster lors du chargement du dictionnaire ou d'autres modifications.

• Modifications du nom de fichier : Évitez de modifier le nom d'un fichier de dictionnaire de synonymes actuellement utilisé. Cela pourrait provoquer des anomalies dans les index qui dépendent de ce dictionnaire.

Procédure

Étapes suivantes : Application des synonymes et vérification

Après avoir chargé le fichier de dictionnaire de synonymes et laissé le cluster redémarrer, configurez les analyseurs de vos index pour utiliser le nouveau dictionnaire.

1. Connectez-vous à la console Kibana du cluster.

2. Créez un index (ou réindexez/rouvrez-en un existant) qui utilise l'analyseur de synonymes. Lors de la définition des paramètres et des mappages de votre index, spécifiez le paramètre synonyms_path pour pointer vers votre fichier de dictionnaire chargé (par exemple, "synonyms_path": "analysis/your_dict_name.txt").

   Pour des instructions détaillées, reportez-vous aux rubriques : Utiliser des synonymes et Using Synonyms (documentation Elasticsearch).

3. Chargez des données de test et effectuez des tests de recherche pour vérifier que les synonymes fonctionnent comme prévu.