Tous les produits
Search
Centre de documentation

Tablestore:GroupByDateHistogram

Dernière mise à jour :Aug 18, 2026

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

DateTimeValue

Oui

Configuration de l'intervalle.

field_range

FieldRange

Oui

Plage de valeurs utilisée conjointement avec interval pour limiter le nombre de groupes. La valeur de (field_range.max-field_range.min)/interval ne peut pas dépasser 2 000.

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.

  • Si ce paramètre n'est pas défini, les lignes comportant un champ vide sont exclues des résultats.

  • S'il est défini, la valeur spécifiée sert de valeur de champ pour ces lignes.

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 +hh:mm ou -hh:mm, par exemple +08:00 ou -09:00.

sort

GroupBySort

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

Aggregations

Non

Sous-agrégations à exécuter sur les résultats de chaque groupe.

sub_group_bys

GroupBys

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.