tuple_difference_theta_integer-Funktion

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

Berechent die Mengendifferenz (A minus B) eines TupleSketch mit ganzzahligen Zusammenfassungen und einer Theta-Skizze. Die zurückgegebene Skizze enthält nur Schlüssel, die im TupleSketch erscheinen, aber nicht im Theta Sketch.

Syntax

tuple_difference_theta_integer ( first, second )

Arguments

• first: Ein TupleSketch im Binärformat mit ganzzahligen Zusammenfassungen (Set A).
• zweitens: Eine Theta-Skizze im binären Format (Menge B), z. B. aus dertheta_sketch_agg aggregierten Funktion.

Rücklieferungen

Ein BINARY Wert, der den TupleSketch enthält, der den Satzunterschied darstellt (A - B).

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.
• Zusammenfassungswerte aus dem TupleSketch werden für Schlüssel im Ergebnis erhalten.
• Diese Funktion ist nicht dieselbe wie tuple_sketch_theta_integer, die die Abtastrate eines TupleSketch zurückgibt.

Häufige Fehlerbedingungen

• TUPLE_INVALID_INPUT_SKETCH_BUFFER
• TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY
• THETA_INVALID_INPUT_SKETCH_BUFFER
• THETA_INVALID_INPUT_SKETCH_BUFFER_FAMILY

Examples

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

Related

• tuple_difference_theta_double Funktion
• tuple_difference_integer Funktion
• theta_sketch_agg Aggregatfunktion