Configuration de base
Configuration d'une application en ligne
Accédez à Search Configuration Center > Retrieval Configuration > Basic Configuration. Sélectionnez une application, puis choisissez l'onglet Online Application pour consulter ses configurations actuelles de tokenisation. Pour modifier le schéma de l'application, cliquez sur Modify Offline Application dans le coin supérieur droit.
Configuration d'une application hors ligne
Accédez à Search Configuration Center > Retrieval Configuration > Basic Configuration. Sélectionnez une application. Dans l'onglet Offline Application, si une version hors ligne de l'application existe, le bouton Modify Offline Application est remplacé par Configure.
Configuration de la tokenisation
Définissez le nom de l'index, son analyseur et ses champs. Pour plus d'informations sur les types d'analyseurs, consultez Analyseurs de texte.
Notes
Vous ne pouvez configurer les méthodes de tokenisation que pour une application hors ligne, et non directement pour une application en ligne.
-
Une application au sein d'une instance ne peut avoir que deux versions à la fois : une en ligne et une hors ligne. Si une version hors ligne existe déjà :
Si vous modifiez des configurations, telles que les paramètres de l'analyseur ou le schéma de l'application, avant la fin de la réindexation, les modifications précédentes enregistrées dans l'application hors ligne sont ignorées.
Si la réindexation est déjà terminée et que vous effectuez une autre modification déclenchant une nouvelle réindexation (par exemple, en modifiant le schéma de l'application ou une source de données), le système supprime la version hors ligne existante avant d'en créer une nouvelle.
OpenSearch sépare l'enregistrement du schéma de l'application de la réindexation. Cette conception garantit que votre schéma d'application est conservé même si le processus de réindexation échoue.
Procédure
Remarque : cet exemple montre comment modifier une application en ligne à l'aide d'un analyseur personnalisé. Un analyseur personnalisé n'est généralement nécessaire que pour corriger des erreurs spécifiques de tokenisation ; les analyseurs par défaut suffisent dans la plupart des scénarios.
1. Accédez à Search Configuration Center > Retrieval Configuration > Analyzer Management, et créez un analyseur personnalisé.
Dans la boîte de dialogue Create Analyzer qui s'affiche, saisissez un Name pour l'analyseur et sélectionnez un Analyzer type, tel que General Analyzer.
2. Ajoutez des entrées d'intervention à l'analyseur personnalisé.
Sur la page Analyzer Management, repérez l'analyseur cible et cliquez sur Entry Management dans la colonne Actions. Sur la page Entry Management, cliquez sur Add. Dans le panneau Add Intervention Entry qui apparaît, renseignez les champs Query et Tokenization result, puis cliquez sur Save. Remarque : séparez les termes du résultat de tokenisation par des espaces. Par exemple, pour tokeniser « beefjerky » en deux termes, saisissez « beef jerky ».
3. Revenez à la page Basic Configuration pour modifier l'application en ligne et appliquer l'analyseur personnalisé.
Pour configurer le schéma de l'index, cliquez sur le bouton Configure dans le coin supérieur droit afin d'accéder au mode édition. Pour Analysis method, sélectionnez Custom analyzer et choisissez l'analyseur que vous venez de créer.
4. Configurez la synchronisation incrémentielle des données et le déploiement automatique pour la nouvelle version.
Après avoir configuré le schéma de l'index, cliquez sur Next pour ouvrir la boîte de dialogue New Version. Par défaut, les deux options sont activées. Si vous désactivez une option :
Do not synchronize real-time incremental data from the online application to the offline application : pendant le processus de construction de la nouvelle version, le système ne synchronisera pas les nouvelles données envoyées via une API ou depuis une source de données vers la nouvelle version.
Do not automatically publish after full reindexing is complete : si vous sélectionnez cette option, le système ne publiera pas automatiquement la nouvelle version en ligne après une construction réussie. Cette version est conservée et n'est pas soumise à la règle de suppression automatique des versions hors ligne après 8 heures.
5. Après avoir enregistré la configuration, une nouvelle application hors ligne apparaît avec le statut Rebuilding Index.
Remarque : comme l'application comporte deux versions (en ligne et hors ligne) et que l'application hors ligne est en cours de réindexation, le bouton Modify Offline Application de l'application en ligne est désactivé.
6. Une fois que le système a réindexé avec succès l'application hors ligne, celle-ci devient la nouvelle application en ligne si le déploiement automatique est activé.
Vous pouvez vérifier la modification sur la page Basic Configuration. Sélectionnez l'onglet Online Application et confirmez que la Analysis method de l'index title affiche votre analyseur personnalisé. Le bouton Modify Offline Application est à nouveau disponible.
Précautions
Une application au sein d'une seule instance OpenSearch ne peut avoir que deux versions à la fois : une en ligne et une hors ligne. Si une application possède déjà les deux versions, la modification de son schéma écrase la version hors ligne existante.
Les modifications apportées à l'analyseur ne prennent effet qu'après la réindexation.