Partager via


tuple_union_agg_integer Fonction d’agrégation

S’applique à :check marqué oui Databricks Runtime 18.1 et versions ultérieures

Unions plusieurs représentations binaires TupleSketch avec des résumés entiers dans un croquis fusionné unique. Utilisez cette fonction pour combiner des croquis pré-agrégés à partir de différentes partitions ou sources de données.

Syntaxe

tuple_union_agg_integer ( sketch [, lgNomEntries [, mode ]] )

Arguments

  • croquis : Un TupleSketch au format binaire avec des résumés entiers (comme à partir de tuple_sketch_agg_integer).
  • lgNomEntries : littéral facultatif INTEGER spécifiant le journal-base-2 des entrées nominales pour l’union. Doit être compris entre 4 et 26, inclus. La valeur par défaut est 12.
  • mode : littéral facultatif STRING spécifiant le mode d’agrégation pour combiner des résumés de clés en double. Valeurs valides : 'sum', 'min', 'max', 'alwaysone'. La valeur par défaut est 'sum'.

Retours

Valeur BINARY contenant le TupleSketch fusionné avec des résumés entiers.

Remarques

  • NULL Les croquis d’entrée sont ignorés pendant l’agrégation.
  • L’opération union combine des croquis même lorsqu’ils ont des valeurs lgNomEntries différentes.
  • Pour fusionner exactement deux croquis, utilisez la fonction tuple_union_integer scalaire.

Messages d’erreur

Exemples

-- Union sketches from different partitions
> SELECT tuple_sketch_estimate_integer(tuple_union_agg_integer(sketch)) FROM (
    SELECT tuple_sketch_agg_integer(key, summary) as sketch FROM VALUES (1, 5), (2, 10) tab(key, summary)
    UNION ALL
    SELECT tuple_sketch_agg_integer(key, summary) as sketch FROM VALUES (2, 3), (3, 7) tab(key, summary)
  );
3.0