適用於:
執行環境 18.2 及以上版本
將帶有雙重摘要的 TupleSketch 與使用 set union 的 Theta Sketch 合併。
Syntax
tuple_union_theta_double ( first, second [, lgNomEntries [, mode ]] )
Arguments
- 第一:一個二進位格式的雙重摘要元組草圖。
-
第二:二元格式的 Theta 草圖,例如來自
theta_sketch_agg總體函數。 -
lgNomEntries:一個可選
INTEGER的字面值,指定名詞條目的對數基數為2。 必須年齡介於4到26歲之間,包含在內。 預設值為 12。 -
模式:一個可選
STRING的文字,指定聚合模式。 有效值:'sum'、'min'、'max'、'alwaysone'。 預設值為'sum'。
Returns
一個 BINARY 包含合併後雙重摘要的 TupleSketch 值。
如果 first 或 second 為 NULL,則結果為 NULL。
附註
- 參數順序固定:
first必須是 TupleSketch,且second必須是 Theta Sketch。 將草圖類型逆向傳遞會提升 TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY。 - Theta Sketch 鍵預設為雙重摘要,基於
mode:0.0對'sum'、'min'+Infinity、-Infinity'max'或1.0'alwaysone'。 - 當鍵同時出現在兩個草圖中時,摘要值會依據
mode合併。
常見錯誤條件
- TUPLE_INVALID_INPUT_SKETCH_BUFFER
- TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY(元組_無效輸入_繪圖緩衝區系列)
- THETA_INVALID_INPUT_SKETCH_BUFFER (THETA無效的輸入草圖緩衝區)
- 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_double(
tuple_union_theta_double(
tuple_sketch_agg_double(col1, val1),
theta_sketch_agg(col2)
)
) FROM VALUES (1, 1.0D, 4), (2, 2.0D, 5), (3, 3.0D, 6) tab(col1, val1, col2);
6.0