funktion tuple_difference_theta_integer

Gäller för:check markerat ja Databricks Runtime 18.2 och senare

Beräknar mängddifferensen (A minus B) för en TupleSketch med heltalssammanfattningar och en Theta-skiss. Den returnerade skissen innehåller endast nycklar som förekommer i TupleSketch men inte i Theta Sketch.

Syntax

tuple_difference_theta_integer ( first, second )

Arguments

  • först: En TupleSketch i binärt format med heltalssammanfattningar (ange A).
  • för det andra: En Theta-skiss i binärt format (set B), såsom från theta_sketch_agg aggregerad funktion.

Returns

Ett BINARY värde som innehåller TupleSketch som representerar den angivna skillnaden (A – B).

Om first eller second är NULLär NULLresultatet .

Notes

  • Argumentordningen är fast: first måste vara en TupleSketch och second måste vara en Theta Sketch. Att skicka skisstyperna i omvänd ordning höjer TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY.
  • Sammanfattningsvärden från TupleSketch bevaras för nycklar i resultatet.
  • Denna funktion är inte densamma som tuple_sketch_theta_integer, som returnerar samplingsfrekvensen för en TupleSketch.

Vanliga felvillkor

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
  • Uppdaterades senast