tuple_difference_theta_integer 関数

適用対象:はい Databricks Runtime 18.2 以降とマークされているチェック

整数要約とシータスケッチの集合差(AマイナB)を計算します。 返されたスケッチには、タプルスケッチには現れるキーのみが含まれ、シータスケッチには存在しません。

Syntax

tuple_difference_theta_integer ( first, second )

Arguments

  • 最初: 整数の概要 (セット A) を含むバイナリ形式の TupleSketch。
  • 第二に:集計関数など、二進形式(集合B)のシータスケッチtheta_sketch_agg。

Returns

セットの差 (A - B) を表す TupleSketch を含む BINARY 値。

first または second が NULL の場合、結果は NULL になります。

Notes

  • 引数の順序は固定されており、 first はタプルスケッチ、 second はシータスケッチでなければなりません。 スケッチタイプを逆順に通過させると TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILYが上がります。
  • TupleSketchの要約値は、結果のキーごとに保持されます。
  • この関数は、タプルスケッチのサンプリングレートを返す tuple_sketch_theta_integerとは異なります。

一般的なエラー状態

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