适用于:
Databricks Runtime 18.2 及更高版本
通过集合并集合并一个带有整数摘要的元组草图和一个 Theta 草图。
Syntax
tuple_union_theta_integer ( first, second [, lgNomEntries [, mode ]] )
Arguments
- first:采用二进制格式的元组和整数摘要。
-
第二:二进制格式的Theta草图,如聚
theta_sketch_agg合函数。 -
lgNomEntries:指定名义条目的 log-base-2 的可选
INTEGER文本。 必须介于 4 到 26 之间(含)。 默认值为 12。 -
mode:指定聚合模式的可选
STRING文字。 有效值:'sum'、、'min''max'、'alwaysone'。 默认值为'sum'。
Returns
一个 BINARY 值,包含包含包含整数摘要的合并元组。
如果 first 或 second 为 NULL,则结果为 NULL。
Notes
- 参数顺序固定:
first必须是 TupleSketch,必须second是 Theta Sketch。 将草图类型反向传递则提升 TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY。 - Theta Sketch键被赋予一个基于
mode0:对于'sum',最大INTEGER值'min'为,INTEGER最小值'max'为,或1。'alwaysone' - 当键同时出现在两个草图中时,汇总值会根据
mode合并。
常见错误条件
- TUPLE_INVALID_INPUT_SKETCH_BUFFER
- TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY
- THETA_INVALID_INPUT_SKETCH_BUFFER
- THETA_INVALID_INPUT_SKETCH_BUFFER_FAMILY (无效的输入示意图缓冲家庭)
- SKETCH_INVALID_LG_NOM_ENTRIES
- DATATYPE_MISMATCH。TYPE_CHECK_FAILURE_WITH_HINT
- 元组_无效_草图_模式
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