tuple_union_theta_integer функция

Область применения:check помечена да Databricks Runtime 18.2 и выше

Объединяет TupleSketch с целочисленными сводками и Theta Sketch с помощью объединения множеств.

Syntax

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

Arguments

  • во-первых: TupleSketch в двоичном формате с целыми сводные данные.
  • второй: Тета-эскиз в бинарном формате, например, из theta_sketch_agg агрегированной функции.
  • lgNomEntries: необязательный INTEGER литерал, указывающий log-base-2 номинальных записей. Должно быть от 4 до 26 включительно. Значение по умолчанию — 12.
  • режим: необязательный STRING литерал, указывающий режим агрегирования. Допустимые значения: 'sum', , 'min''max''alwaysone'. Значение по умолчанию — 'sum'.

Returns

Значение BINARY , содержащее объединенный TupleSketch с целыми сводками.

Если first или second равно NULL, возвращается результат NULL.

Notes

  • Порядок аргументов фиксирован: first должен быть TupleSketch и second тета-эскиз. Передача типов эскизов в обратном порядке увеличивает TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY.
  • Клавишам Theta Sketch присваивается стандартное целочисленное сводное значение на modeоснове : 0 для '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