tuple_difference_theta_double-Funktion

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

Berechent die Mengendifferenz (A minus B) eines TupleSketch mit doppelten 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_double ( first, second )

Arguments

• first: Ein TupleSketch im Binärformat mit doppelten 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 identisch mit tuple_sketch_theta_double, 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_double(
    tuple_difference_theta_double(
      tuple_sketch_agg_double(col1, val1),
      theta_sketch_agg(col2)
    )
  ) FROM VALUES (5, 5.0D, 4), (1, 1.0D, 4), (2, 2.0D, 5), (3, 3.0D, 1) tab(col1, val1, col2);
2.0

Related

• tuple_difference_theta_integer Funktion
• tuple_difference_double Funktion
• theta_sketch_agg Aggregatfunktion