Приведённая ниже документация сгенерирована на основе системной таблицы
system.functions.dotProduct
Добавленный в: v21.11.0 Вычисляет скалярное произведение двух векторов (кортежей или массивов одинакового размера). Возвращает сумму произведений соответствующих элементов. СинтаксисscalarProduct
Аргументы
vector1— Первый вектор.Array(T)илиTuple(T)vector2— Второй вектор. Должен быть того же размера, что и первый.Array(T)илиTuple(T)
BFloat16 накопление выполняется в Float32, и результат также возвращается как Float32. (U)Int* или Float* или Decimal
Примеры
Базовое использование
Query
Response
flattenTuple
Добавленный в: v22.6.0 Преобразует именованный вложенный Tuple в плоский. Элементами возвращаемого Tuple являются пути входного Tuple. Синтаксисinput— Именованный вложенный Tuple, который нужно развернуть.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 Объединяет Tuple, переданные в качестве аргументов. СинтаксисtupleN— Произвольное количество аргументов типа Tuple.Tuple(T)
Tuple(T)
Примеры
Пример использования
Query
Response
tupleDivide
Добавленный в: v21.11.0 Вычисляет поэлементное деление двух или более Tuple одинакового размера слева направо.Деление на ноль вернёт
inf.t1— Первый входной кортеж.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)t2, ..., tN— Один или несколько дополнительных входных Tuple. Все Tuple должны иметь одинаковую длину.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Два Tuple
Query
Response
Query
Response
tupleDivideByNumber
Добавленный в: v21.11.0 Возвращает кортеж, все элементы которого разделены на число.Деление на ноль вернёт
inf.tuple— Кортеж для деления.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)number— Делитель.(U)Int*илиFloat*илиDecimal
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Базовое использование
Query
Response
tupleElement
Добавленный в: v1.1.0 Извлекает элемент из кортежа по индексу или имени. Для доступа по индексу ожидается числовой индекс, начиная с 1. Для доступа по имени имя элемента можно указать в виде строки (работает только для именованных кортежей). Поддерживаются отрицательные индексы. В этом случае выбирается соответствующий элемент с нумерацией от конца. Например,tuple.-1 — это последний элемент в кортеже.
Необязательный третий аргумент задает значение по умолчанию, которое возвращается вместо того, чтобы генерировать исключение, если запрашиваемый элемент не существует.
Все аргументы должны быть константами.
Эта функция не имеет накладных расходов во время выполнения и реализует операторы x.index и x.name.
Синтаксис
tuple— Кортеж или массив кортежей.Tuple(T)илиArray(Tuple(T))index— Индекс столбца, нумерация с 1.const UInt8/16/32/64name— Имя элемента.const Stringdefault_value— Значение по умолчанию, возвращаемое, если индекс выходит за границы или элемент отсутствует.Any
Any
Примеры
Доступ по индексу
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
tupleHammingDistance
Добавленный в: v21.1.0 Возвращает расстояние Хэмминга между двумя Tuple одинаковой длины.Тип результата определяется так же, как для арифметических функций, на основе количества элементов во входных Tuple.
UInt8/16/32/64
Примеры
Пример использования
Query
Response
Query
Response
tupleIntDiv
Добавленный в: v23.8.0 Выполняет поэлементное целочисленное деление двух или более Tuple одинакового размера последовательно слева направо. Возвращает Tuple частных. Если какой-либо Tuple содержит нецелочисленные элементы, результат вычисляется с округлением до ближайшего целого для каждого нецелочисленного делимого или делителя. Деление на 0 вызывает исключение. Синтаксисt1— Первый входной Tuple.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)t2, ..., tN— Один или несколько дополнительных входных Tuple. Все Tuple должны быть одинакового размера.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Два Tuple
Query
Response
Query
Response
Query
Response
tupleIntDivByNumber
Добавленный в: v23.8.0 Выполняет целочисленное деление кортежа числителей на заданный знаменатель и возвращает кортеж частных. Если один из входных параметров содержит нецелые элементы, результат вычисляется с округлением до ближайшего целого для каждого нецелого числителя или делителя. При делении на 0 будет сгенерировано исключение. Синтаксисtuple_num— Кортеж значений делимого.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)div— Значение делителя.(U)Int*илиFloat*илиDecimal
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Базовое использование
Query
Response
Query
Response
tupleIntDivOrZero
Добавленный в: v23.8.0 Как иtupleIntDiv, выполняет поэлементное целочисленное деление двух или более Tuple одинакового размера слева направо.
В случае деления на 0 для этого элемента возвращает 0 вместо того, чтобы генерировать исключение.
Если любой Tuple содержит нецелочисленные элементы, результат вычисляется путем округления каждого нецелочисленного числителя или делителя до ближайшего целого числа.
Синтаксис
t1— Первый входной Tuple.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)t2, ..., tN— Один или несколько дополнительных входных Tuple. Все Tuple должны иметь одинаковый размер.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
С нулевыми делителями
Query
Response
Query
Response
tupleIntDivOrZeroByNumber
Добавленный в: v23.8.0 Как иtupleIntDivByNumber, выполняет целочисленное деление кортежа числителей на заданный делитель и возвращает кортеж частных.
При делении на ноль не вызывает ошибку, а вместо этого возвращает нулевое частное.
Если кортеж или div содержат нецелочисленные элементы, результат вычисляется с округлением каждого нецелочисленного числителя или делителя до ближайшего целого.
Синтаксис
tuple_num— Кортеж значений числителя.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)div— Значение делителя.(U)Int*илиFloat*илиDecimal
0, возвращается 0. Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Базовое использование
Query
Response
Query
Response
tupleMinus
Добавленный в: v21.11.0 Вычисляет поэлементную разность двух или более Tuple одинакового размера; операция применяется слева направо. СинтаксисvectorDifference
Аргументы
t1— Первый входной Tuple.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)t2, ..., tN— Один или несколько последующих входных Tuple. Все Tuple должны иметь одинаковую длину.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Два Tuple
Query
Response
Query
Response
tupleModulo
Добавленный в: v23.8.0 Возвращает Tuple с поэлементными остатками от деления двух или более Tuple одинакового размера; операция применяется слева направо. Синтаксисt1— Первый входной Tuple.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)t2, ..., tN— Один или несколько дополнительных входных Tuple. Все Tuple должны иметь одинаковую длину.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Два Tuple
Query
Response
Query
Response
tupleModuloByNumber
Добавленный в: v23.8.0 Возвращает кортеж остатков от деления элементов кортежа на заданный делитель. Синтаксисtuple_num— Кортеж элементов делимого.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)div— Значение делителя.(U)Int*илиFloat*илиDecimal
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Базовое использование
Query
Response
tupleMultiply
Добавленный в: v21.11.0 Вычисляет поэлементное произведение двух или более Tuple одного размера. Синтаксисt1— Первый входной Tuple.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)t2, ..., tN— Один или несколько дополнительных входных Tuple. Все Tuple должны иметь одинаковую длину.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Два Tuple
Query
Response
Query
Response
tupleMultiplyByNumber
Добавленный в: v21.11.0 Возвращает кортеж, все элементы которого умножены на число. Синтаксисtuple— Кортеж для умножения.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)number— Множитель.(U)Int*илиFloat*илиDecimal
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Базовое использование
Query
Response
tupleNames
Добавленный в: v24.8.0 Преобразует кортеж в массив имён столбцов. Для кортежа видаTuple(a T, b T, ...) возвращает массив строк, представляющих именованные столбцы кортежа. Если элементы кортежа не имеют явных имён, в качестве имён столбцов вместо них будут использоваться их индексы.
Синтаксис
- Нет.
Query
Response
tupleNegate
Добавленный в: v21.11.0 Вычисляет значения, противоположные элементам кортежа. Синтаксисt— кортеж, к которому применяется отрицание.Tuple((U)Int*)orTuple(Float*)orTuple(Decimal)
Tuple((U)Int*) or Tuple(Float*) or Tuple(Decimal)
Примеры
Базовое использование
Query
Response
tuplePlus
Добавленный в: v21.11.0 Вычисляет поэлементную сумму двух или более Tuple одинаковой длины. СинтаксисvectorSum
Аргументы
t1— Первый входной Tuple.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)t2, ..., tN— Один или несколько дополнительных входных Tuple. Все Tuple должны быть одинакового размера.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)
Tuple((U)Int*) или Tuple(Float*) или Tuple(Decimal)
Примеры
Два Tuple
Query
Response
Query
Response
tuplePositiveModuloByNumber
Добавленный в: v26.4.0 Возвращает кортеж положительных остатков от деления элементов кортежа на заданный делитель. В отличие от tupleModuloByNumber, результат всегда неотрицательный. Синтаксисtuple_num— Tuple значений числителя.Tuple((U)Int*)илиTuple(Float*)илиTuple(Decimal)div— Значение делителя.(U)Int*илиFloat*илиDecimal
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), ...).
Все значения в кортеже должны быть одного типа.
Синтаксис
tuple— Именованный кортеж со значениями любых типов.Tuple(n1 T1[, 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