OpenSearch:Clause d'agrégation

Une seule requête de recherche peut renvoyer des dizaines de milliers de documents. Toutefois, il n'est pas nécessaire de consulter l'intégralité des résultats pour obtenir les informations souhaitées. Si vous souhaitez afficher des statistiques sur les documents récupérés, utilisez une clause d'agrégation.

Syntaxe d'une clause d'agrégation :

group_key:field, range:number1~number2, agg_fun:func1#func2, max_group:number2, 
agg_filter:filter_clause, max_group:number

Paramètres :

• La clause d'agrégation est facultative.

• Les champs référencés dans les paramètres précédents doivent être configurés en tant que champs d'attribut lors de la définition du schéma de l'application.

• Le résultat d'une clause d'agrégation est renvoyé au nœud facet, qui est un nœud utilisé pour les recherches. Les fonctions spécifiées par le paramètre agg_fun, telles que sum() et count(), affichent les statistiques.

• Vous pouvez spécifier plusieurs paramètres group_key dans une clause d'agrégation pour collecter simultanément des statistiques pour différents champs. Séparez les calculs pour chaque champ par des points-virgules (;). Exemple : group_key:field1,agg_fun:func1;group_key:field2,agg_fun:func2.

• Le résultat de la clause d'agrégation est renvoyé au nœud facet. Pour afficher les statistiques dans le résultat renvoyé, vous devez définir le format de la clause config sur full JSON.

• La fonction distinct_count est prise en charge uniquement dans un cluster exclusif. Pour utiliser cette fonction, vous devez ajouter le paramètre enable_accurate_statistics dans une clause kvpairs et le définir sur true. Lorsque cette fonctionnalité est activée, le système renvoie uniquement les statistiques dans le nœud facet pour une requête.

• Les fonctions count(), max(), min() et sum() sont prises en charge dans un cluster exclusif. Pour utiliser ces fonctions, vous devez ajouter le paramètre enable_accurate_statistics dans une clause kvpairs et le définir sur true.

• Le système peut renvoyer des statistiques précises pour jusqu'à 100 000 documents. Si le nombre de documents correspondant aux conditions spécifiées dépasse 100 000, les statistiques renvoyées peuvent être imprécises en raison des limites de performance du moteur. Pour un cluster exclusif, vous pouvez ajouter le paramètre enable_accurate_statistics dans une clause kvpairs et le définir sur true. Le système pourra ainsi renvoyer des statistiques plus précises.

1. Utilisez la clause de requête suivante pour obtenir les statistiques des documents contenant « Zhejiang University ». Les statistiques sont calculées en fonction des champs group_id et company_id. Pour les champs group_id, les statistiques incluent la somme des valeurs et la valeur maximale du champ price. Pour le champ company_id, les statistiques incluent le nombre d'occurrences de chaque entreprise.

   query=default:'Zhejiang University'&&aggregate=group_key:group_id,agg_fun:sum(price)#max(price);group_key:company_id,agg_fun:count()

   Exemple de résultat renvoyé :

   {
   　　status: "OK",
   　　result: {
   　　　　searchtime: 0.015634,
   　　　　total: 5,
   　　　　num: 1,
   　　　　viewtotal: 5,
   　　　　items: [        // The return result.
   　　　　　　{ ... }
   　　　　],
   　　　　facet: [
   　　　　　　{
   　　　　　　　　key: "group_id",
   　　　　　　　　items: [
   　　　　　　　　　　{
   　　　　　　　　　　　　value: 43,
   　　　　　　　　　　　　sum: 81,
   　　　　　　　　　　　　max: 20,
   　　　　　　　　　　},
   　　　　　　　　　　{
   　　　　　　　　　　　　value: 63,
   　　　　　　　　　　　　sum: 91,
   　　　　　　　　　　　　max: 50,
   　　　　　　　　　　},
   　　　　　　　　],
   　　　　　　},
   　　　　　　{
   　　　　　　　　key: "company_id",
   　　　　　　　　items: [
   　　　　　　　　　　{
   　　　　　　　　　　　　value: 13,
   　　　　　　　　　　　　count: 4,
   　　　　　　　　　　},
   　　　　　　　　　　{
   　　　　　　　　　　　　value: 10,
   　　　　　　　　　　　　count: 1,
   　　　　　　　　　　},
   　　　　　　　　],
   　　　　　　},
   　　　　],
   　　},
   　　errors: [ ],
   　　tracer: "",
   },

2. Utilisez la clause de requête suivante pour obtenir les statistiques des documents contenant « Zhejiang University » en fonction du champ group_id. La somme des valeurs du champ price est calculée. Les documents dont le rang est inférieur à 10 000 sont échantillonnés. La taille du pas d'échantillonnage est définie sur 5.

   query=default:'Zhejiang University'&&aggregate=group_key:group_id,agg_fun:sum(price), agg_sampler_threshold:10000, agg_sampler_step:5

3. Utilisez la clause de requête suivante pour obtenir les statistiques des documents contenant « Zhejiang University » en fonction du champ group_id. La clause d'agrégation compte le nombre de documents dont les valeurs du champ group_id se situent dans la plage de 10 à 50.

   query=default:'Zhejiang University'&&aggregate=group_key:group_id,agg_fun:count(),range:10~50

4. Utilisez la clause de requête suivante pour obtenir les statistiques des documents contenant « Zhejiang University » en fonction du champ group_id. La somme maximale des champs hits et replies est calculée parmi les documents dont les valeurs du champ create_timestamp sont supérieures à 1423456781.

   query=default:'Zhejiang University'&&aggregate=group_key:group_id,agg_fun:max(hits+replies),agg_filter:create_timestamp>1423456781