Перейти к основному содержанию
Приведённая ниже документация сгенерирована на основе системной таблицы system.functions.

dotProduct

Добавленный в: v21.11.0 Вычисляет скалярное произведение двух векторов (кортежей или массивов одинакового размера). Возвращает сумму произведений соответствующих элементов. Синтаксис
Псевдонимы: scalarProduct Аргументы
  • vector1 — Первый вектор. Array(T) или Tuple(T)
  • vector2 — Второй вектор. Должен быть того же размера, что и первый. Array(T) или Tuple(T)
Возвращаемое значение Возвращает скалярное произведение двух векторов. (U)Int* или Float* или Decimal Примеры Базовое использование
Query
Response

flattenTuple

Добавленный в: v22.6.0 Преобразует именованный вложенный кортеж в плоский. Элементами возвращаемого кортежа являются пути входного кортежа. Синтаксис
Аргументы
  • input — Именованный вложенный кортеж, который нужно развернуть. Tuple(n1 T1[, n2 T2, ... ])
Возвращаемое значение Возвращает выходной кортеж, элементы которого представляют собой пути из исходного входного значения. Tuple(T) Примеры Пример использования
Query
Response

tuple

Добавленный в: v1.1.0 Возвращает кортеж, объединяя входные аргументы. Для столбцов C1, C2, … с типами T1, T2, … возвращается кортеж именованного типа Tuple(C1 T1, C2 T2, …), содержащий эти столбцы, если их имена уникальны и могут использоваться как идентификаторы без кавычек; в противном случае возвращается Tuple(T1, T2, …). Выполнение этой функции не требует дополнительных затрат. Tuple обычно используются как промежуточные значения для аргументов операторов IN или для создания списка формальных параметров лямбда-функций. Tuple нельзя записывать в таблицу. Функция реализует оператор (x, y, ...). Синтаксис
Аргументы
  • Отсутствуют.
Возвращаемое значение Примеры обычный
Query
Response

tupleConcat

Добавленный в: v23.8.0 Объединяет кортежи, переданные в качестве аргументов. Синтаксис
Аргументы
  • tupleN — Произвольное количество аргументов типа Tuple. Tuple(T)
Возвращаемое значение Возвращает кортеж, содержащий все элементы входных кортежей. Tuple(T) Примеры Пример использования
Query
Response

tupleDivide

Добавленный в: v21.11.0 Вычисляет результат деления соответствующих элементов двух кортежей одинакового размера.
При делении на ноль возвращается inf.
Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж с результатом деления. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleDivideByNumber

Добавленный в: v21.11.0 Возвращает кортеж, все элементы которого разделены на число.
Деление на ноль вернёт inf.
Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж с элементами, полученными в результате деления. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleElement

Добавленный в: v1.1.0 Извлекает элемент из Tuple по индексу или имени. Для доступа по индексу ожидается числовой индекс, начиная с 1. Для доступа по имени имя элемента можно указать в виде строки (работает только для именованных Tuple). Поддерживаются отрицательные индексы. В этом случае выбирается соответствующий элемент с нумерацией от конца. Например, tuple.-1 — это последний элемент в Tuple. Необязательный третий аргумент задает значение по умолчанию, которое возвращается вместо того, чтобы генерировать исключение, если запрашиваемый элемент не существует. Все аргументы должны быть константами. Эта функция не имеет накладных расходов во время выполнения и реализует операторы x.index и x.name. Синтаксис
Аргументы
  • tuple — Кортеж или массив кортежей. Tuple(T) или Array(Tuple(T))
  • index — Индекс столбца, нумерация с 1. const UInt8/16/32/64
  • name — Имя элемента. const String
  • default_value — Значение по умолчанию, возвращаемое, если индекс выходит за границы или элемент отсутствует. Any
Возвращаемое значение Возвращает элемент по указанному индексу или имени. Any Примеры Доступ по индексу
Query
Response
Индексация с отрицательными индексами
Query
Response
Именованный кортеж с таблицей
Query
Response
Со значением по умолчанию
Query
Response
Синтаксис оператора
Query
Response

tupleHammingDistance

Добавленный в: v21.1.0 Возвращает расстояние Хэмминга между двумя кортежами одинаковой длины.
Тип результата определяется так же, как для арифметических функций, на основе количества элементов во входных кортежах.
Синтаксис
Аргументы
  • t1 — Первый кортеж. Tuple(*)
  • t2 — Второй кортеж. Tuple(*)
Возвращаемое значение Возвращает расстояние Хэмминга. UInt8/16/32/64 Примеры Пример использования
Query
Response
С MinHash для обнаружения почти одинаковых строк
Query
Response

tupleIntDiv

Добавленный в: v23.8.0 Выполняет целочисленное деление кортежа числителей на кортеж знаменателей. Возвращает кортеж частных. Если хотя бы один из кортежей содержит нецелочисленные элементы, результат вычисляется с округлением каждого нецелочисленного числителя или делителя до ближайшего целого. При делении на 0 генерируется ошибка. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж частных. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response
С десятичными дробями
Query
Response

tupleIntDivByNumber

Добавленный в: v23.8.0 Выполняет целочисленное деление кортежа числителей на заданный знаменатель и возвращает кортеж частных. Если один из входных параметров содержит нецелые элементы, результат вычисляется с округлением до ближайшего целого для каждого нецелого числителя или делителя. При делении на 0 будет сгенерировано исключение. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж частных. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response
С десятичными числами
Query
Response

tupleIntDivOrZero

Добавленный в: v23.8.0 Как и tupleIntDiv, выполняет целочисленное деление кортежа числителей на кортеж знаменателей и возвращает кортеж частных. В случае деления на 0 возвращает частное 0 вместо того, чтобы генерировать исключение. Если любой из кортежей содержит нецелочисленные элементы, результат вычисляется путем округления каждого нецелочисленного числителя или делителя до ближайшего целого числа. Синтаксис
Аргументы Возвращаемое значение Возвращает Tuple частных. Для частных, где делитель равен 0, возвращает 0. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры С нулевыми делителями
Query
Response

tupleIntDivOrZeroByNumber

Добавленный в: v23.8.0 Как и tupleIntDivByNumber, выполняет целочисленное деление кортежа числителей на заданный делитель и возвращает кортеж частных. При делении на ноль не вызывает ошибку, а вместо этого возвращает нулевое частное. Если кортеж или div содержат нецелочисленные элементы, результат вычисляется с округлением каждого нецелочисленного числителя или делителя до ближайшего целого. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж частных; для частных, где делитель равен 0, возвращается 0. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response
При нулевом делителе
Query
Response

tupleMinus

Добавленный в: v21.11.0 Вычисляет разность соответствующих элементов двух кортежей одинакового размера. Синтаксис
Псевдонимы: vectorDifference Аргументы Возвращаемое значение Возвращает кортеж с результатами вычитания. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleModulo

Добавленный в: v23.8.0 Возвращает кортеж остатков от деления двух кортежей. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж остатков от деления. При делении на ноль генерируется исключение. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleModuloByNumber

Добавленный в: v23.8.0 Возвращает кортеж остатков от деления элементов кортежа на заданный делитель. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж остатков от деления. При делении на ноль возникает ошибка. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleMultiply

Добавленный в: v21.11.0 Вычисляет произведение соответствующих элементов двух кортежей одного размера. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж с результатами умножения. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleMultiplyByNumber

Добавленный в: v21.11.0 Возвращает кортеж, все элементы которого умножены на число. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж с умноженными элементами. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleNames

Добавленный в: v24.8.0 Преобразует кортеж в массив имён столбцов. Для кортежа вида Tuple(a T, b T, ...) возвращает массив строк, представляющих именованные столбцы кортежа. Если элементы кортежа не имеют явных имён, в качестве имён столбцов вместо них будут использоваться их индексы. Синтаксис
Аргументы
  • Нет.
Возвращаемое значение Примеры обычный
Query
Response

tupleNegate

Добавленный в: v21.11.0 Вычисляет значения, противоположные элементам кортежа. Синтаксис
Аргументы Возвращаемое значение Возвращает кортеж с результатом отрицания. Tuple((U)Int*) or Tuple(Float*) or Tuple(Decimal) Примеры Базовое использование
Query
Response

tuplePlus

Добавленный в: v21.11.0 Вычисляет сумму соответствующих элементов двух кортежей одного размера. Синтаксис
Псевдонимы: vectorSum Аргументы Возвращаемое значение Возвращает кортеж, содержащий суммы соответствующих элементов входных кортежей. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tuplePositiveModuloByNumber

Добавленный в: v26.4.0 Возвращает кортеж положительных остатков от деления элементов кортежа на заданный делитель. В отличие от tupleModuloByNumber, результат всегда неотрицательный. Синтаксис
Аргументы Возвращаемое значение Возвращает Tuple неотрицательных остатков. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal) Примеры Базовое использование
Query
Response

tupleToNameValuePairs

Добавленный в: v21.9.0 Преобразует кортеж в массив пар (имя, значение). Например, кортеж Tuple(n1 T1, n2 T2, ...) преобразуется в Array(Tuple('n1', T1), Tuple('n2', T2), ...). Все значения в кортеже должны быть одного типа. Синтаксис
Аргументы Возвращаемое значение Возвращает массив из пар (name, value). Array(Tuple(String, T)) Примеры Именованный кортеж
Query
Response
Безымянный кортеж
Query
Response

untuple

Выполняет синтаксическую подстановку элементов кортежа в месте вызова. Имена результирующих столбцов зависят от реализации и могут меняться. Не следует полагаться на конкретные имена столбцов после untuple. Синтаксис
Вы можете использовать выражение EXCEPT, чтобы исключить столбцы из результата запроса. Аргументы
  • x — функция tuple, столбец или кортеж элементов. Tuple.
Возвращаемое значение
  • Отсутствует.
Примеры Входная таблица:
Пример использования столбца типа Tuple в качестве параметра функции untuple:
Query
Response
Пример использования выражения EXCEPT:
Query
Response

Функции расстояния

Описание всех поддерживаемых функций приведено в документации по функциям расстояния.
Последнее изменение 19 июня 2026 г.