tuple_union_theta_integer 函數

適用於:已勾選為 Databricks 執行環境 18.2 及以上版本

結合一個帶有整數摘要的 TupleSketch 與一個 Theta Sketch,使用集合聯集。

Syntax

tuple_union_theta_integer ( first, second [, lgNomEntries [, mode ]] )

Arguments

  • 第一:一個帶有整數摘要的二進位格式 TupleSketch。
  • 第二:二元格式的 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 鍵會根據以下條件被分配一個預設的整數摘要:對於 ,最大值'min',INTEGER為 ,'alwaysone''max'1INTEGER或 ,為 。'sum'0mode
  • 當鍵同時出現在兩個草圖中時,摘要值會依據 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