L'agrégation GroupByDateHistogram regroupe les résultats de requête selon des intervalles de date. Les lignes dont les valeurs de champ appartiennent au même intervalle sont placées dans le même groupe. Chaque groupe renvoie sa plage de valeurs ainsi que le nombre de lignes correspondantes.
Paramètres de requête
message GroupByDateHistogram {
optional string field_name = 1;
optional DateTimeValue interval = 2;
optional FieldRange field_range = 3;
optional bytes missing = 4;
optional int64 min_doc_count = 5;
optional string time_zone = 6;
optional GroupBySort sort = 7;
optional Aggregations sub_aggs = 8;
optional GroupBys sub_group_bys = 9;
}
|
Paramètre |
Type |
Obligatoire |
Description |
|
field_name |
string |
Oui |
Champ sur lequel agréger. |
|
interval |
Oui |
Configuration de l'intervalle. |
|
|
field_range |
Oui |
Plage de valeurs utilisée conjointement avec |
|
|
missing |
bytes |
Non |
Valeur par défaut attribuée aux lignes dont le champ est vide. La valeur doit être encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer.
|
|
min_doc_count |
int64 |
Non |
Nombre minimal de lignes qu'un groupe doit contenir pour figurer dans les résultats. Les groupes contenant moins de lignes sont exclus. |
|
time_zone |
string |
Non |
Décalage du fuseau horaire au format |
|
sort |
Non |
Règles de tri appliquées aux groupes. Par défaut, les groupes sont triés par ordre décroissant. Lorsque plusieurs règles sont spécifiées, elles sont appliquées dans l'ordre indiqué. |
|
|
sub_aggs |
Non |
Sous-agrégations à exécuter sur les résultats de chaque groupe. |
|
|
sub_group_bys |
Non |
Opérations de sous-regroupement (Sub-GroupBy) à exécuter sur les résultats de chaque groupe. |
Paramètres de réponse
message GroupByDateHistogramResult {
repeated GroupByDateHistogramItem group_by_date_histogram_items = 1;
}
|
Paramètre |
Type |
Obligatoire |
Description |
|
group_by_date_histogram_items |
repeated GroupByDateHistogramItem |
Oui |
Groupes renvoyés. |