tuple_difference_theta_double функция

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

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

Syntax

tuple_difference_theta_double ( 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_double, который возвращает частоту дискретизации TupleSketch.

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

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

Examples

> SELECT tuple_sketch_estimate_double(
    tuple_difference_theta_double(
      tuple_sketch_agg_double(col1, val1),
      theta_sketch_agg(col2)
    )
  ) FROM VALUES (5, 5.0D, 4), (1, 1.0D, 4), (2, 2.0D, 5), (3, 3.0D, 1) tab(col1, val1, col2);
2.0

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

• tuple_difference_theta_integer функция
• tuple_difference_double функция
• theta_sketch_agg агрегатная функция