Configurez les champs d'affichage par défaut pour définir les champs du schéma de l'application à extraire et renvoyer pour chaque requête de recherche. Utilisez le paramètre fetch_fields afin de ne récupérer que les champs nécessaires à l'affichage dans votre application.
Fonctionnement
Deux niveaux de configuration déterminent les champs renvoyés :
| Niveau | Condition d'application |
|---|---|
| Valeur par défaut de la console | Aucune valeur fetch_fields n'est transmise dans la requête |
Paramètre fetch_fields du SDK ou de l'API |
Une valeur est spécifiée au moment de la requête — elle remplace la valeur par défaut de la console |
Définir les champs d'affichage par défaut dans la console
Connectez-vous à la console OpenSearch. Dans le volet de navigation de gauche, choisissez Feature Extensions > Search Result Display.
-
Dans la section Default Display Fields, ajoutez les champs à renvoyer.
Dans la section Default Display Fields, cliquez sur l'icône de modification située à la fin de la liste des champs pour ajouter ou modifier les champs d'affichage.
Si vous n'avez pas encore défini de valeur par défaut dans la console, vous pouvez également ajouter des champs d'affichage lors d'un test de recherche pour une application.
Remarque : Séparez les différentes valeurs de champ par des points-virgules (;) .
Sur la page de test de recherche, dans la zone des paramètres, utilisez le paramètre fetch_fields pour spécifier les champs à renvoyer. Par exemple, fetch_fields=buy,cate_id,title renvoie uniquement les champs buy, cate_id et title.
Remplacer les champs d'affichage au moment de la requête
La transmission du paramètre fetch_fields dans un appel SDK ou une requête API remplace la valeur par défaut de la console pour cette requête spécifique. Ne spécifiez que les champs dont votre client a besoin, car la taille des données textuelles renvoyées a un impact significatif sur les performances de la recherche.
Paramètres de l'API : Consultez la rubrique Initiate search requests pour savoir comment utiliser le paramètre fetch_fields dans les appels API.
SDK pour Java : L'exemple suivant spécifie les champs à renvoyer.
// Specify the fields to return in search results.
config.setFetchFields(Lists.newArrayList("id", "name", "phone", "int_arr", "literal_arr", "float_arr", "cate_id"));Limites
Scénarios JOIN multi-tables : Les champs de clé primaire des tables secondaires ne peuvent pas être définis comme champs d'affichage par défaut. Pour inclure les valeurs de clé primaire des tables secondaires dans les résultats de recherche, utilisez plutôt les champs associés dans la table principale.
Par exemple, si la table principale p_table possède la clé primaire id et que la table secondaire s_table_1 possède la clé primaire id_1, la spécification de fetch_fields=id_1 lors d'un test de recherche ne renvoie pas la valeur de la clé primaire de la table secondaire. En revanche, la spécification de fetch_fields=id (le champ associé dans la table principale) renvoie les résultats attendus.