GroupByHistogram définit la fonctionnalité de regroupement par histogramme. Cette fonctionnalité permet de regrouper les résultats de requête selon des intervalles de données spécifiques. Les valeurs de champ comprises dans la même plage sont rassemblées. La réponse inclut la plage de valeurs de chaque groupe ainsi que le nombre de valeurs qu'il contient.
Paramètres de requête
message GroupByHistogram {
optional string field_name = 1;
optional bytes interval = 2;
optional bytes missing = 3;
optional int64 min_doc_count = 4;
optional GroupBySort sort = 5;
optional FieldRange field_range = 6;
optional Aggregations sub_aggs = 7;
optional GroupBys sub_group_bys = 8;
}|
Parameter |
Type |
Required |
Description |
|
field_name |
string |
Yes |
Champ utilisé pour l'agrégation. |
|
interval |
bytes |
Yes |
Intervalle statistique. La valeur doit être encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. |
|
missing |
bytes |
No |
Valeur par défaut attribuée à un champ lorsque sa valeur est vide dans la ligne. La valeur doit être encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer.
|
|
min_doc_count |
int64 |
No |
Nombre minimal de lignes. Si le nombre de lignes d'un groupe est inférieur à ce seuil, les résultats d'agrégation correspondants ne sont pas renvoyés. |
|
sort |
No |
Règles de tri appliquées aux éléments d'un groupe. Par défaut, les éléments sont triés par ordre décroissant. Lorsque plusieurs règles de tri sont configurées, les données sont triées selon l'ordre de définition des règles. |
|
|
field_range |
Yes |
Plage utilisée conjointement avec le paramètre interval pour limiter le nombre de groupes. Le résultat du calcul basé sur la formule |
|
|
sub_aggs |
No |
Opération de sous-agrégation. Vous pouvez appliquer cette opération aux résultats du regroupement. |
|
|
sub_group_bys |
No |
Opération de sous-regroupement (sub-GroupBy). Vous pouvez appliquer cette opération aux résultats du regroupement. |
Paramètres de réponse
message GroupByHistogramResult {
repeated GroupByHistogramItem group_by_histogra_items = 1;
}|
Parameter |
Type |
Required |
Description |
|
group_by_histogra_items |
repeated GroupByHistogramItem |
Yes |
Informations relatives aux groupes renvoyés. |