tuple_union_theta_integer 函数

适用于:检查标记为是 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合并。

常见错误条件

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