pyspark.sql.functions.tuple_difference_theta_integer#

pyspark.sql.functions.tuple_difference_theta_integer(col1, col2)[source]#

Subtracts a Datasketches ThetaSketch from a TupleSketch with integer summaries (elements in TupleSketch but not in ThetaSketch).

New in version 4.2.0.

Parameters

col1Column or column name: The TupleSketch column with integer summaries
col2Column or column name: The ThetaSketch column

Returns

Column: The binary representation of the difference TupleSketch.

See also

pyspark.sql.functions.tuple_sketch_agg_integer()
pyspark.sql.functions.theta_sketch_agg()
pyspark.sql.functions.tuple_union_theta_integer()
pyspark.sql.functions.tuple_intersection_theta_integer()

Examples

>>> from pyspark.sql import functions as sf
>>> df = spark.createDataFrame([(5, 5, 4), (1, 1, 4), (2, 2, 5), (3, 3, 1)], ["key1", "v1", "key2"])  # noqa
>>> df = df.agg(
...     sf.tuple_sketch_agg_integer("key1", "v1").alias("sketch1"),
...     sf.theta_sketch_agg("key2").alias("sketch2")
... )
>>> df.select(sf.tuple_sketch_estimate_integer(sf.tuple_difference_theta_integer(df.sketch1, "sketch2"))).show()  # noqa
+-------------------------------------------------------------------------------+
|tuple_sketch_estimate_integer(tuple_difference_theta_integer(sketch1, sketch2))|
+-------------------------------------------------------------------------------+
|                                                                            2.0|
+-------------------------------------------------------------------------------+