OpenSearch:Service usage

Cette rubrique répond aux questions courantes sur la configuration d'OpenSearch, la gestion des données, le comportement de recherche, les API, les SDK et la mise en surbrillance des résultats.

Qu'est-ce qu'OpenSearch ?

OpenSearch est un service de recherche cloud dédié aux données structurées. Grâce à la console OpenSearch, créez des services de recherche évolutifs et personnalisables sans gérer l'infrastructure sous-jacente. Définissez votre schéma, chargez vos données et interrogez-les à l'aide de l'API OpenSearch ou de l'un des SDK fournis. Pour une présentation des SDK disponibles, consultez la rubrique Présentation des SDK.

Quels sont les avantages d'OpenSearch ?

OpenSearch s'exécute sur l'infrastructure Alibaba Cloud et adapte automatiquement les ressources matérielles à mesure que vos données augmentent, sans investissement matériel initial. Les requêtes de recherche s'exécutent indépendamment de vos serveurs d'application, ce qui garantit que la charge de recherche n'affecte pas vos services existants. OpenSearch renvoie rapidement des résultats pertinents et classés, contribuant ainsi à améliorer l'engagement des utilisateurs et la qualité des sessions.

Combien de requêtes de recherche puis-je envoyer ?

Il n'existe aucune limite stricte sur le nombre total de requêtes de recherche. Définissez votre quota de requêtes par seconde (QPS) dans la console OpenSearch en fonction du trafic prévu. Pour les charges de travail à haut débit QPS, soumettez un ticket à l'avance : OpenSearch ajuste automatiquement les ressources pour gérer la charge, une opération qui peut prendre quelques jours.

Quelle est la latence d'une requête de recherche ?

La latence dépend de deux facteurs : la complexité de la requête et le nombre de documents correspondants. Testez la latence avec vos propres données et modèles de requête afin d'obtenir des estimations précises adaptées à votre cas d'utilisation.

Comment fonctionne la facturation d'OpenSearch ?

OpenSearch prend en charge deux méthodes de facturation : la facturation basée sur le stockage et les QPS, et la facturation basée sur l'unité de calcul logique (LCU). Pour plus de détails, consultez Présentation. Si vous optez pour la facturation basée sur le stockage et les QPS, les données de consommation LCU surveillées ne s'appliquent pas à la facturation ; utilisez-les uniquement pour évaluer les performances de recherche.

Qu'est-ce qu'une application ? Comment créer une application ?

Dans OpenSearch, une application est une instance de recherche autonome : il s'agit d'une collection de documents partageant un même schéma et une même configuration de recherche. Pour la configurer, définissez vos tables de données et les types de champs, configurez les propriétés de recherche, puis chargez les données. Une fois créée, vous pouvez l'interroger via l'API.

Créez, gérez et supprimez des applications depuis la console OpenSearch ou via l'API OpenSearch.

Pourquoi dois-je générer des index lors de la définition du schéma d'une application ?

Les index rendent la recherche par mots-clés possible. Lorsque vous définissez un champ d'index, OpenSearch construit un index inversé à partir d'un ou plusieurs champs source. Sans champs d'index, les requêtes basées sur des mots-clés n'ont aucun élément sur lequel s'appuyer.

Par exemple, un forum pourrait nécessiter deux modes de recherche :

• Recherche complète couvrant le titre, le corps et l'auteur : mappez ces champs source vers le champ d'index default, puis interrogez avec query=default:'keyword'.

• Recherche limitée au titre : mappez uniquement le champ source du titre vers un champ d'index title_search, puis interrogez avec query=title_search:'keyword'.

Qu'est-ce qu'un modèle ?

Les modèles sont des configurations d'application prédéfinies (schémas et méthodes de tri) basées sur des modèles de données courants. Lors de la création d'une application dans la console OpenSearch, choisissez parmi les modèles disponibles afin de réduire le temps de configuration.

Puis-je modifier le schéma d'une application créée à partir d'un modèle ?

Oui. Dans la console OpenSearch, accédez à la page de détails de l'application et cliquez sur Modify Offline Application. Pour des instructions détaillées, consultez Effectuer des modifications hors ligne.

Comment charger des données dans une application ?

La méthode dépend de votre source de données :

• ApsaraDB RDS, MaxCompute ou PolarDB : Configurez la source de données dans la console OpenSearch. La synchronisation des données, y compris les mises à jour continues, s'effectue automatiquement.

• Autres sources : Chargez les données en appelant l'API OpenSearch ou en utilisant la fonctionnalité de chargement disponible dans la console OpenSearch.

Combien de documents puis-je charger dans une application ?

Il n'existe aucune limite intégrée. Définissez votre quota de documents dans la console OpenSearch en fonction de votre volume réel de données. Pour les importations ponctuelles de grande ampleur, soumettez un ticket à l'avance ; le processus est similaire à la demande d'un quota QPS élevé. Un quota de documents plus élevé augmente les coûts de stockage, alors définissez-le en adéquation avec vos besoins réels.

Comment supprimer une application ?

1. Connectez-vous à la console OpenSearch.

2. Accédez à la page de détails de l'application.

3. Cliquez sur Delete Application.

4. Confirmez la suppression dans la boîte de dialogue.

Comment supprimer un document dans une application ?

Exécutez une instruction DELETE à l'aide d'un SDK OpenSearch, ou supprimez le document directement depuis la page Search Test dans la console OpenSearch.

Comment vider une application ?

Cela dépend de si vous souhaitez conserver le nom de l'application :

• Conserver le nom de l'application : Supprimez les documents un par un depuis l'intérieur de l'application. Les applications de l'édition avancée prennent en charge la vidange planifiée : les documents peuvent être conservés de 7 à 180 jours avant leur suppression automatique.

• Abandonner le nom de l'application : Créez une nouvelle application et copiez-y les configurations de l'originale.

  FAQ relative à l'importation de données

Puis-je importer des données depuis une instance ApsaraDB RDS vers OpenSearch ?

Oui. Configurez votre instance ApsaraDB RDS comme source de données pour une application OpenSearch. Après l'importation initiale complète et la reconstruction des index, les mises à jour incrémentielles provenant de l'instance RDS sont synchronisées automatiquement vers OpenSearch.

Quels services Alibaba Cloud peuvent servir de sources de données pour les applications OpenSearch ?

OpenSearch prend en charge ApsaraDB RDS, MaxCompute et PolarDB en tant que sources de données.

Quel format est pris en charge lorsque j'appelle l'API OpenSearch ou utilise un SDK OpenSearch pour charger des documents ?

Seul le format JSON est pris en charge. Pour plus de détails sur le format, consultez les modèles dans la console OpenSearch ou reportez-vous à la section Traitement des données.

Quelle est la différence entre l'instruction ADD et l'instruction UPDATE ?

La différence réside dans la manière dont elles gèrent les champs sans valeur spécifiée :

• ADD : Les champs non spécifiés sont définis avec leurs valeurs par défaut.

• UPDATE : Les champs non spécifiés restent inchangés (aucune valeur n'est écrite).

  FAQ relative à la recherche

Quels types de recherches OpenSearch prend-il en charge ?

OpenSearch prend en charge les recherches textuelles et numériques, avec des capacités de requête, de filtrage, de tri, de statistiques et d'agrégation. Parmi les fonctionnalités supplémentaires figurent les index personnalisés, le tri personnalisé des résultats, les suggestions de liste déroulante et l'analyse de recherche configurable (synonymes, correction intelligente). Des modèles prédéfinis basés sur des modèles de données courants sont également disponibles.

Puis-je récupérer tous les documents d'une application ?

Non. OpenSearch est un moteur de recherche conçu pour récupérer efficacement les résultats les plus pertinents, et non pour exporter l'intégralité du jeu de données. Chaque requête ne renvoie qu'un nombre limité de documents. Pour la pagination, définissez le paramètre viewtotal dans la réponse. Pour connaître les limites applicables, consultez la section Limites.

Pourquoi un tableau s'affiche-t-il sous forme de chaîne dans les résultats de recherche ?

OpenSearch utilise un caractère de tabulation (\t) comme délimiteur entre les éléments du tableau dans les résultats de recherche.

OpenSearch prend-il en charge les analyseurs personnalisés et les dictionnaires personnalisés ?

OpenSearch prend en charge plusieurs méthodes d'analyse intégrées et vous permet de personnaliser les méthodes d'analyse. Tous les dictionnaires dans OpenSearch partagent le même ensemble de configurations. Les dictionnaires personnalisés ne sont pas pris en charge. Pour consulter les options disponibles, reportez-vous à la section Champs et analyseurs.

Pourquoi ne puis-je pas trouver le document contenant « chi fan le » lorsque je recherche « chi fan le ma » ?

OpenSearch exige que tous les termes analysés soient présents dans un document pour qu'il apparaisse dans les résultats. Lorsque vous recherchez query=default:'chi fan le ma', OpenSearch la réécrit comme suit :

query=default:'chi fan' AND default:'le' AND default:'ma'

Étant donné que le document ne contient pas « ma », il est exclu.

Pour gérer ce type de recherche longue traîne, configurez les pondérations de termes dans vos paramètres d'analyse de recherche. Avec les pondérations de termes, OpenSearch utilise la fonction RANK pour les termes à faible pondération au lieu de AND, de sorte que la requête devient :

query=default:'chi fan' RANK default:'le' RANK default:'ma'

Cela permet de récupérer les documents contenant « chi fan le » et de les classer au-dessus des documents ne contenant que « chi fan ».

Pourquoi ne puis-je pas trouver le document contenant « mxplayer » lorsque je recherche « mx » ou « player » ?

OpenSearch analyse le texte anglais au niveau des mots. « mxplayer » est traité comme un seul jeton, donc la recherche de « mx », « player » ou « mx player » ne correspondra pas.

OpenSearch prend-il en charge les requêtes de recherche dans des langues autres que le chinois et l'anglais ?

OpenSearch fournit une analyse sémantique complète pour le chinois et l'anglais. Pour les autres langues utilisant des espaces comme délimiteurs, telles que le portugais et le russe, OpenSearch prend en charge la correspondance de mots de base mais pas l'analyse sémantique. Les langues sans délimiteurs d'espace, telles que le japonais et le coréen, ne sont pas prises en charge. Des analyseurs généraux sont disponibles pour le thaï et le vietnamien. Pour la liste complète, consultez Analyseurs de texte.

Comment afficher l'article le plus pertinent de chaque magasin ainsi que le nombre total de correspondances par magasin ?

Utilisez conjointement les clauses aggregate et distinct. La clause distinct classe les résultats de recherche en types distincts, et la clause aggregate agrège les résultats du même type.

OpenSearch prend-il en charge la mise en cache des résultats de recherche ?

Oui. Les requêtes identiques effectuées dans un délai de 5 minutes renvoient des résultats mis en cache. Par défaut, la fonctionnalité de mise en cache des résultats de recherche est activée. Vous ne pouvez ni désactiver cette fonctionnalité ni modifier sa configuration.

Quel est le point de terminaison de l'API OpenSearch ?

OpenSearch est déployé dans plusieurs régions, avec un point de terminaison dédié par région. Trouvez le point de terminaison de votre application sur sa page de détails dans la console OpenSearch.

J'ai chargé des données à l'aide d'un SDK OpenSearch et reçu une réponse status OK. Pourquoi une erreur apparaît-elle dans la console OpenSearch ?

Une réponse status OK confirme qu'OpenSearch a bien reçu vos données ; cela ne signifie pas que les données ont été traitées avec succès. Les erreurs de traitement sont consignées séparément dans les journaux d'erreurs de la console OpenSearch.

Si les données que vous avez chargées n'apparaissent pas dans les résultats de recherche :

1. Vérifiez les journaux d'erreurs dans la console OpenSearch.

2. Identifiez et corrigez tout problème de schéma ou de format de données.

3. Réimportez les données concernées.

OpenSearch ne fournit aucune opération d'API pour interroger directement les messages d'erreur.

Pour toute autre question, soumettez un ticket.

FAQ relative à la mise en surbrillance

Qu'est-ce que la longueur du segment ?

La longueur du segment définit la longueur maximale du résumé du résultat de recherche pour un champ. Seuls les termes apparaissant dans la limite de cette longueur de segment sont mis en surbrillance en rouge dans les résultats.

À quoi servent les points de suspension (...) ?

Des points de suspension relient plusieurs segments dans un résumé de résultat. Par exemple, si un champ fait 1 000 octets et que la longueur du segment est de 200 octets, jusqu'à trois segments de 200 octets peuvent être renvoyés, reliés par des points de suspension. Seuls les termes correspondants au sein de chaque segment sont mis en surbrillance en rouge.