tuple_union_theta_integer Fonction

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

Fusionne un TupleSketch avec des résumés entiers et un Theta Sketch en utilisant l’union des ensembles.

Syntax

tuple_union_theta_integer ( first, second [, lgNomEntries [, mode ]] )

Arguments

  • first : Un TupleSketch au format binaire avec des résumés entiers.
  • deuxièmement : un croquis thêta au format binaire, comme à partir d’unetheta_sketch_agg fonction agrégée.
  • lgNomEntries : littéral facultatif INTEGER spécifiant le journal-base-2 des entrées nominales. 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. Valeurs valides : 'sum', , 'min''max', 'alwaysone'. La valeur par défaut est 'sum'.

Returns

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

Si first ou second est NULL, le résultat est NULL.

Notes

  • L’ordre des arguments est fixe : first doit être un TupleSketch et second un Theta Sketch. Passer les types de croquis dans l’ordre inverse augmente TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY.
  • Les clés Theta Sketch se voient attribuer un résumé entier par défaut basé sur : pour , la valeur maximale INTEGER pour 'min', la valeur minimale INTEGER pour 'max', ou 1 pour 'alwaysone'.'sum'0mode
  • Lorsqu’une clé apparaît dans les deux croquis, les valeurs résumées sont combinées selon .mode

Conditions d’erreur courantes

Examples

> SELECT tuple_sketch_estimate_integer(
    tuple_union_theta_integer(
      tuple_sketch_agg_integer(col1, val1),
      theta_sketch_agg(col2)
    )
  ) FROM VALUES (1, 1, 4), (2, 2, 5), (3, 3, 6) tab(col1, val1, col2);
6.0