適用対象:はい Databricks Runtime 18.2 以降と![]()
セットユニオンを用いて、整数サマリーとTheta Sketchを統合します。
Syntax
tuple_union_theta_integer ( first, second [, lgNomEntries [, mode ]] )
Arguments
- first: 整数の概要を含むバイナリ形式の TupleSketch。
-
第二に:集計関数のような二進形式のシータスケッチ
theta_sketch_agg。 -
lgNomEntries: わずかなエントリの log-base-2 を指定する省略可能な
INTEGERリテラル。 4 ~ 26 の範囲で指定する必要があります。 既定値は 12 です。 -
mode: 集計モードを指定する省略可能な
STRINGリテラル。 有効な値:'sum'、'min'、'max'、'alwaysone'。 既定値は'sum'です。
Returns
マージされた TupleSketch と整数の概要を含む BINARY 値。
first または second が NULL の場合、結果は NULL になります。
Notes
- 引数の順序は固定されており、
firstはタプルスケッチ、secondはシータスケッチでなければなりません。 スケッチタイプを逆順に通過させると TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILYが上がります。 - シータスケッチキーは
modeに基づいてデフォルトの整数要約が割り当てられます:'sum'は0、'min'は最大INTEGER値、'max'は最小INTEGER値、'alwaysone'は1です。 - 両方のスケッチにキーが現れた場合、要約値はそれぞれ
modeに合算されます。
一般的なエラー状態
- TUPLE_INVALID_INPUT_SKETCH_BUFFER
- タプル_無効_入力_スケッチ_バッファ_ファミリー
- THETA_INVALID_INPUT_SKETCH_BUFFER(不正な入力スケッチバッファ)
- THETA_INVALID_INPUT_SKETCH_BUFFER_FAMILY
- SKETCH_INVALID_LG_NOM_ENTRIES
- DATATYPE_MISMATCH。TYPE_CHECK_FAILURE_WITH_HINT
- TUPLE_INVALID_SKETCH_MODE
Examples
> SELECT tuple_sketch_estimate_integer(
tuple_union_theta_integer(
tuple_sketch_agg_integer(col1, val1),
theta_sketch_agg(col2)
)
) FROM VALUES (1, 1, 4), (2, 2, 5), (3, 3, 6) tab(col1, val1, col2);
6.0