tuple_union_theta_integer-Funktion

Gilt für:check marked yes Databricks Runtime 18.2 und höher

Fügt einen TupleSketch mit ganzzahligen Zusammenfassungen und eine Theta-Skizze unter Verwendung der Mengenvereinigung zusammen.

Syntax

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

Arguments

  • first: Ein TupleSketch im Binärformat mit ganzzahligen Zusammenfassungen.
  • zweitens: Eine Theta-Skizze im Binärformat, z. B. aus dertheta_sketch_agg Aggregatfunktion.
  • lgNomEntries: Ein optionales INTEGER Literal, das die Log-Base-2 von Nominaleinträgen angibt. Muss zwischen 4 und 26 einschließlich liegen. Der Standardwert ist 12.
  • modus: Ein optionales STRING Literal, das den Aggregationsmodus angibt. Gültige Werte: 'sum', 'min', 'max', . 'alwaysone' Der Standardwert lautet 'sum'.

Rücklieferungen

Ein BINARY Wert, der den zusammengeführten TupleSketch mit ganzzahligen Zusammenfassungen enthält.

Wenn first oder secondNULL ist, ist das Ergebnis NULL.

Notizen

  • Die Argumentreihenfolge ist festgelegt: first muss ein TupleSketch sein und second muss ein Theta Sketch sein. Das Übergeben der Skizzentypen in umgekehrter Reihenfolge ergibt TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY.
  • Theta-Skizzen-Schlüssel erhalten eine Standard-Ganzzahl-Zusammenfassung basierend auf : für , den maximalen INTEGER Wert für 'min', dem minimalen INTEGER Wert für 'max', oder 1 für 'alwaysone'.'sum'0mode
  • Wenn in beiden Skizzen ein Schlüssel erscheint, werden die Zusammenfassungswerte gemäß modekombiniert.

Häufige Fehlerbedingungen

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
  • Zuletzt aktualisiert um