tuple_difference_theta_integer функция

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

Вычисляет разницу множеств (A минус B) для TupleSketch с целочисленными сводками и Theta-Sketch. Возвращённый эскиз содержит только клавиши, которые встречаются в TupleSketch, но не присутствуют в Theta Sketch.

Syntax

tuple_difference_theta_integer ( first, second )

Arguments

• сначала: TupleSketch в двоичном формате с целыми сводками (set A).
• второй: Тета-эскиз в бинарном формате (множество B), например, из theta_sketch_agg агрегированной функции.

Returns

BINARY Значение, содержащее TupleSketch, представляющее разницу набора (A - B).

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

Notes

• Порядок аргументов фиксирован: first должен быть TupleSketch и second тета-эскиз. Передача типов эскизов в обратном порядке увеличивает TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY.
• Сводные значения из TupleSketch сохраняются для ключей в результате.
• Эта функция отличается от tuple_sketch_theta_integer, который возвращает частоту дискретизации TupleSketch.

Распространенные условия ошибки

• TUPLE_INVALID_INPUT_SKETCH_BUFFER (Неверный входной буфер эскиза кортежа)
• TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY
• THETA_НЕПРАВИЛЬНЫЙ_ВХОДНОЙ_ЭСКИЗ_БУФЕР
• THETA_INVALID_INPUT_SKETCH_BUFFER_FAMILY

Examples

> SELECT tuple_sketch_estimate_integer(
    tuple_difference_theta_integer(
      tuple_sketch_agg_integer(col1, val1),
      theta_sketch_agg(col2)
    )
  ) FROM VALUES (5, 5, 4), (1, 1, 4), (2, 2, 5), (3, 3, 1) tab(col1, val1, col2);
2.0

Связанные темы

• tuple_difference_theta_double функция
• tuple_difference_integer функция
• theta_sketch_agg агрегатная функция