Функции для работы с массивами

array

Добавленный в: v1.1.0 Создаёт массив из аргументов функции. Аргументы должны быть константами и иметь типы с общим супертипом. Нужно передать как минимум один аргумент, иначе будет неясно, массив какого типа создавать. Это означает, что эту функцию нельзя использовать для создания пустого массива. Для этого используйте функцию emptyArray*. Для той же цели используйте оператор [ ]. Синтаксис

array(x1 [, x2, ..., xN])

Аргументы

x1 — Константное значение любого типа T. Если указан только этот аргумент, массив будет иметь тип T. - [, x2, ..., xN] — Дополнительные N константных значений с общим супертипом с x1

Возвращаемое значение Возвращает массив, где ‘T’ — наименьший общий тип среди переданных аргументов. Array(T) Примеры Допустимое использование

Query

SELECT array(toInt32(1), toUInt16(2), toInt8(3)) AS a, toTypeName(a)

Response

┌─a───────┬─toTypeName(a)─┐
│ [1,2,3] │ Array(Int32)  │
└─────────┴───────────────┘

Недопустимое использование

Query

SELECT array(toInt32(5), toDateTime('1998-06-16'), toInt8(5)) AS a, toTypeName(a)

Response

Received exception from server (version 25.4.3):
Code: 386. DB::Exception: Received from localhost:9000. DB::Exception:
There is no supertype for types Int32, DateTime, Int8 ...

arrayAUCPR

Добавленный в: v20.4.0 Вычисляет площадь под кривой точность-полнота (PR). Кривая точность-полнота строится путём откладывания точности по оси y и полноты по оси x для всех порогов. Итоговое значение лежит в диапазоне от 0 до 1, при этом более высокое значение указывает на лучшую производительность модели. PR AUC особенно полезен для несбалансированных наборов данных, поскольку в таких случаях даёт более наглядное представление о производительности, чем ROC AUC. Подробнее см. здесь, здесь и здесь. Синтаксис

arrayAUCPR(scores, labels[, partial_offsets])

Псевдонимы: arrayPRAUC Аргументы

cores — Оценки, выдаваемые моделью предсказания. Array((U)Int*) или Array(Float*)
labels — Метки примеров: обычно 1 для положительного примера и 0 для отрицательного. Array((U)Int*) или Array(Enum)
partial_offsets —
Необязательно. Array(T) из трёх неотрицательных целых чисел для вычисления частичной площади под PR-кривой (что эквивалентно вертикальной полосе в PR-пространстве) вместо полного AUC. Этот параметр полезен при распределённом вычислении PR AUC. Массив должен содержать следующие элементы [higher_partitions_tp, higher_partitions_fp, total_positives].
- higher_partitions_tp: Количество положительных меток в партициях с более высокими оценками.
- higher_partitions_fp: Количество отрицательных меток в партициях с более высокими оценками.
- total_positives: Общее количество положительных примеров во всём наборе данных.

При использовании arr_partial_offsets arr_scores и arr_labels должны представлять только одну партицию всего набора данных, содержащую интервал оценок. Набор данных следует разбить на непрерывные партиции, где каждая партиция содержит подмножество данных, оценки которых попадают в определённый диапазон. Например:

Одна партиция может содержать все оценки в диапазоне [0, 0.5).
Другая партиция может содержать оценки в диапазоне [0.5, 1.0].

Возвращаемое значение Возвращает площадь под кривой точность-полнота (PR). Float64 Примеры Пример использования

Query

SELECT arrayAUCPR([0.1, 0.4, 0.35, 0.8], [0, 0, 1, 1]);

Response

┌─arrayAUCPR([0.1, 0.4, 0.35, 0.8], [0, 0, 1, 1])─┐
│                              0.8333333333333333 │
└─────────────────────────────────────────────────┘

arrayAll

Добавленный в: v1.1.0 Возвращает 1, если лямбда-функция func(x [, y1, y2, ... yN]) возвращает true для всех элементов. В противном случае возвращает 0. Синтаксис

arrayAll(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — лямбда-функция, которая работает с элементами исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — исходный массив для обработки. Array(T)
cond1_arr, ... — Необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает 1, если лямбда-функция возвращает true для всех элементов, иначе 0 UInt8 Примеры Все элементы удовлетворяют условию

Query

SELECT arrayAll(x, y -> x=y, [1, 2, 3], [1, 2, 3])

Response

Не все элементы совпадают

Query

SELECT arrayAll(x, y -> x=y, [1, 2, 3], [1, 1, 1])

Response

arrayAutocorrelation

Добавленный в: v26.4.0 Вычисляет автокорреляцию массива. Если указан max_lag, корреляция вычисляется только для лагов в диапазоне [0, max_lag). Если max_lag не указан, она вычисляется для всех возможных лагов. Синтаксис

arrayAutocorrelation(arr, [max_lag])

Аргументы

arr — Массив чисел. Array(T)
max_lag — Необязательный параметр. Максимальное число вычисляемых лагов. Должен быть неотрицательным целым числом. Integer

Возвращаемое значение Возвращает массив значений типа Float64. Возвращает NaN, если дисперсия равна 0. Array(Float64) Примеры Линейный

Query

SELECT arrayAutocorrelation([1, 2, 3, 4, 5]);

Response

[1, 0.4, -0.1, -0.4, -0.4]

Симметричный

Query

SELECT arrayAutocorrelation([10, 20, 10]);

Response

[1, -0.6666666666666669, 0.16666666666666674]

Константа

Query

SELECT arrayAutocorrelation([5, 5, 5]);

Response

[nan, nan, nan]

Ограничено

Query

SELECT arrayAutocorrelation([1, 2, 3, 4, 5], 2);

Response

[1, 0.4]

arrayAvg

Добавленный в: v21.1.0 Возвращает среднее значение элементов исходного массива. Если указана лямбда-функция func, возвращает среднее значение результатов лямбда-функции. Синтаксис

arrayAvg([func(x[, y1, ..., yN])], source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Необязательно. Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, которые передают дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает среднее арифметическое элементов исходного массива или, если указана лямбда-функция, среднее арифметическое элементов её результатов. Float64 Примеры Базовый пример

Query

SELECT arrayAvg([1, 2, 3, 4]);

Response

2.5

Использование с лямбда-функцией

Query

SELECT arrayAvg(x, y -> x*y, [2, 3], [2, 3]) AS res;

Response

6.5

arrayCompact

Добавленный в: v20.1.0 Удаляет из массива подряд идущие повторяющиеся элементы, включая значения null. Порядок значений в результирующем массиве определяется порядком элементов в исходном массиве. Синтаксис

arrayCompact(arr)

Аргументы

arr — Массив, из которого удаляются дубликаты. Array(T)

Возвращаемое значение Возвращает массив без повторяющихся значений Array(T) Примеры Пример использования

Query

SELECT arrayCompact([1, 1, nan, nan, 2, 3, 3, 3]);

Response

[1,nan,2,3]

arrayConcat

Добавленный в: v1.1.0 Объединяет массивы, переданные в качестве аргументов. Синтаксис

arrayConcat(arr1 [, arr2, ... , arrN])

Аргументы

arr1 [, arr2, ... , arrN] — N массивов, которые нужно объединить. Array(T)

Возвращаемое значение Возвращает один массив, полученный объединением переданных массивов. Array(T) Примеры Пример использования

Query

SELECT arrayConcat([1, 2], [3, 4], [5, 6]) AS res

Response

[1, 2, 3, 4, 5, 6]

arrayCount

Добавленный в: v1.1.0 Возвращает количество элементов, для которых func(arr1[i], ..., arrN[i]) возвращает true. Если func не указана, возвращает количество ненулевых элементов в массиве. arrayCount — это функция высшего порядка. Синтаксис

arrayCount([func, ] arr1, ...)

Аргументы

func — Необязательный. Функция, применяемая к каждому элементу массива (массивов). Лямбда-функция
arr1, ..., arrN — N массивов. Array(T)

Возвращаемое значение Возвращает количество элементов, для которых func возвращает true. В противном случае возвращает количество ненулевых элементов в массиве. UInt32 Примеры Пример использования

Query

SELECT arrayCount(x -> (x % 2), groupArray(number)) FROM numbers(10)

Response

arrayCumSum

Добавленный в: v1.1.0 Возвращает массив частичных (накопленных) сумм элементов исходного массива. Если указана лямбда-функция, сумма вычисляется путем применения лямбда-функции к элементам массива на каждой позиции. Синтаксис

arrayCumSum([func,] arr1[, arr2, ... , arrN])

Аргументы

func — Необязательно. Лямбда-функция, применяемая к элементам массива на каждой позиции. Лямбда-функция
arr1 — Исходный массив числовых значений. Array(T)
[arr2, ..., arrN] — Необязательно. Дополнительные массивы того же размера, передаваемые в качестве аргументов лямбда-функции, если она указана. Array(T)

Возвращаемое значение Возвращает массив накопленных сумм элементов исходного массива. Тип результата совпадает с числовым типом входного массива. Array(T) Примеры Базовое использование

Query

SELECT arrayCumSum([1, 1, 1, 1]) AS res

Response

[1, 2, 3, 4]

С лямбда-функцией

Query

SELECT arrayCumSum(x -> x * 2, [1, 2, 3]) AS res

Response

[2, 6, 12]

arrayCumSumNonNegative

Добавленный в: v18.12.0 Возвращает массив частичных (накопительных) сумм элементов исходного массива, заменяя любую отрицательную накопительную сумму на ноль. Если указана лямбда-функция, сумма вычисляется путем применения этой функции к элементам массива для каждой позиции. Синтаксис

arrayCumSumNonNegative([func,] arr1[, arr2, ... , arrN])

Аргументы

func — Необязательно. Лямбда-функция, применяемая к элементам массива в каждой позиции. Лямбда-функция
arr1 — Исходный массив числовых значений. Array(T)
[arr2, ..., arrN] — Необязательно. Дополнительные массивы того же размера, передаваемые в лямбда-функцию в качестве аргументов, если она указана. Array(T)

Возвращаемое значение Возвращает массив частичных сумм элементов исходного массива, в котором любая отрицательная накопленная сумма заменяется нулём. Тип результата соответствует числовому типу входного массива. Array(T) Примеры Базовое использование

Query

SELECT arrayCumSumNonNegative([1, 1, -4, 1]) AS res

Response

[1, 2, 0, 1]

С лямбда-выражением

Query

SELECT arrayCumSumNonNegative(x -> x * 2, [1, -2, 3]) AS res

Response

[2, 0, 6]

arrayDifference

Добавленный в: v1.1.0 Вычисляет массив разностей между соседними элементами массива. Первым элементом результирующего массива будет 0, вторым — arr[1] - arr[0], третьим — arr[2] - arr[1] и так далее. Тип элементов результирующего массива определяется правилами вывода типов для вычитания (например, UInt8 - UInt8 = Int16). Синтаксис

arrayDifference(arr)

Аргументы

arr — массив Array, для которого вычисляются разности между соседними элементами. Array(T)

Возвращаемое значение Возвращает массив разностей между соседними элементами массива UInt* Примеры Пример использования

Query

SELECT arrayDifference([1, 2, 3, 4]);

Response

[0,1,1,1]

Пример переполнения из-за типа результата Int64

Query

SELECT arrayDifference([0, 10000000000000000000]);

Response

┌─arrayDifference([0, 10000000000000000000])─┐
│ [0,-8446744073709551616]                   │
└────────────────────────────────────────────┘

arrayDistinct

Добавленный в: v1.1.0 Возвращает массив, содержащий только уникальные элементы исходного массива. Синтаксис

arrayDistinct(arr)

Аргументы

arr — Массив, из которого нужно извлечь уникальные элементы. Array(T)

Возвращаемое значение Возвращает массив, содержащий уникальные элементы. Array(T) Примеры Пример использования

Query

SELECT arrayDistinct([1, 2, 2, 3, 1]);

Response

[1,2,3]

arrayDotProduct

Добавленный в: v23.5.0 Возвращает скалярное произведение двух массивов.

Размеры двух векторов должны быть одинаковыми. Типы Array и Tuple также могут содержать элементы разных типов.

Синтаксис

arrayDotProduct(v1, v2)

Аргументы

v1 — Первый вектор. Array((U)Int* | Float* | Decimal) или Tuple((U)Int* | Float* | Decimal)
v2 — Второй вектор. Array((U)Int* | Float* | Decimal) или Tuple((U)Int* | Float* | Decimal)

Возвращаемое значение Скалярное произведение двух векторов.

Возвращаемый тип определяется типами аргументов. Если Array или Tuple содержат элементы разных типов, то тип результата — супертип.

(U)Int* или Float* или Decimal Примеры Пример с Array

Query

SELECT arrayDotProduct([1, 2, 3], [4, 5, 6]) AS res, toTypeName(res);

Response

32    UInt16

Пример с Tuple

Query

SELECT dotProduct((1::UInt16, 2::UInt8, 3::Float32),(4::Int16, 5::Float32, 6::UInt8)) AS res, toTypeName(res);

Response

32    Float64

arrayElement

Добавленный в: v1.1.0 Возвращает элемент указанного массива с индексом n, где n может быть любым целочисленным типом. Если индекс выходит за пределы массива, возвращается значение по умолчанию (0 для чисел, пустая строка для строк и т. д.), за исключением случаев, когда аргументом является неконстантный массив, а индекс 0 — константа. В этом случае возникнет ошибка Array indices are 1-based.

Массивы в ClickHouse индексируются с 1.

Поддерживаются отрицательные индексы. В этом случае выбирается соответствующий элемент с нумерацией от конца. Например, arr[-1] — последний элемент массива. Оператор [n] обеспечивает ту же функциональность. Синтаксис

arrayElement(arr, n)

Аргументы

arr — Массив, в котором выполняется поиск. Array(T). - n — Позиция элемента, который требуется получить. (U)Int*.

Возвращаемое значение Возвращает один объединённый массив из переданных массивов-аргументов Array(T) Примеры Пример использования

Query

SELECT arrayElement(arr, 2) FROM (SELECT [1, 2, 3] AS arr)

Response

Отрицательные индексы

Query

SELECT arrayElement(arr, -1) FROM (SELECT [1, 2, 3] AS arr)

Response

Использование нотации [n]

Query

SELECT arr[2] FROM (SELECT [1, 2, 3] AS arr)

Response

Индекс выходит за границы массива

Query

SELECT arrayElement(arr, 4) FROM (SELECT [1, 2, 3] AS arr)

Response

arrayElementOrNull

Добавленный в: v1.1.0 Возвращает элемент указанного массива по индексу n, где n может иметь любой целочисленный тип. Если индекс выходит за границы массива, вместо значения по умолчанию возвращается NULL.

Массивы в ClickHouse индексируются с 1.

Поддерживаются отрицательные индексы. В этом случае выбирается соответствующий элемент, отсчитываемый с конца. Например, arr[-1] — это последний элемент массива. Синтаксис

arrayElementOrNull(arrays)

Аргументы

arrays — Произвольное количество аргументов типа массив. Array

Возвращаемое значение Возвращает один общий массив, объединяющий переданные аргументы-массивы. Array(T) Примеры Пример использования

Query

SELECT arrayElementOrNull(arr, 2) FROM (SELECT [1, 2, 3] AS arr)

Response

Индексация с отрицательными индексами

Query

SELECT arrayElementOrNull(arr, -1) FROM (SELECT [1, 2, 3] AS arr)

Response

Индекс выходит за пределы массива

Query

SELECT arrayElementOrNull(arr, 4) FROM (SELECT [1, 2, 3] AS arr)

Response

NULL

arrayEnumerate

Добавленный в: v1.1.0 Возвращает массив [1, 2, 3, ..., length (arr)] Эта функция обычно используется с оператором ARRAY JOIN. Она позволяет выполнять подсчёт только один раз для каждого массива после применения ARRAY JOIN. Эту функцию также можно использовать в функциях высшего порядка. Например, с её помощью можно получить индексы элементов массива, соответствующих условию. Синтаксис

arrayEnumerate(arr)

Аргументы

arr — массив, который нужно пронумеровать. Array

Возвращаемое значение Возвращает массив [1, 2, 3, ..., length (arr)]. Array(UInt32) Примеры Базовый пример с ARRAY JOIN

Query

CREATE TABLE test
(
    `id` UInt8,
    `tag` Array(String),
    `version` Array(String)
)
ENGINE = MergeTree
ORDER BY id;

INSERT INTO test VALUES (1, ['release-stable', 'dev', 'security'], ['2.4.0', '2.6.0-alpha', '2.4.0-sec1']);

SELECT
    id,
    tag,
    version,
    seq
FROM test
ARRAY JOIN
    tag,
    version,
    arrayEnumerate(tag) AS seq

Response

┌─id─┬─tag────────────┬─version─────┬─seq─┐
│  1 │ release-stable │ 2.4.0       │   1 │
│  1 │ dev            │ 2.6.0-alpha │   2 │
│  1 │ security       │ 2.4.0-sec1  │   3 │
└────┴────────────────┴─────────────┴─────┘

arrayEnumerateDense

Добавленный в: v18.12.0 Возвращает массив того же размера, что и исходный, показывая, где каждый элемент впервые встречается в исходном массиве. Синтаксис

arrayEnumerateDense(arr)

Аргументы

arr — Массив, который нужно пронумеровать. Array(T)

Возвращаемое значение Возвращает массив того же размера, что и arr, указывающий позицию первого вхождения каждого элемента в исходном массиве Array(T) Примеры Пример использования

Query

SELECT arrayEnumerateDense([10, 20, 10, 30])

Response

[1,2,1,3]

arrayEnumerateDenseRanked

Добавленный в: v20.1.0 Возвращает массив того же размера, что и исходный, указывая, где каждый элемент впервые встречается в исходном массиве. Позволяет выполнять нумерацию многомерного массива с возможностью указать, на какую глубину просматривать массив. Синтаксис

arrayEnumerateDenseRanked(clear_depth, arr, max_array_depth)

Аргументы

clear_depth — Отдельно нумерует элементы на указанном уровне. Должен быть меньше или равен max_arr_depth. UInt*
arr — N-мерный массив, элементы которого нужно пронумеровать. Array(T)
max_array_depth — Максимальная эффективная глубина. Должна быть меньше или равна глубине arr. UInt*

Возвращаемое значение Возвращает массив, указывающий, где каждый элемент впервые встречается в исходном массиве Array Примеры Базовое использование

Query

-- При clear_depth=1 и max_array_depth=1 результат идентичен результату arrayEnumerateDense.

SELECT arrayEnumerateDenseRanked(1,[10, 20, 10, 30],1);

Response

[1,2,1,3]

Использование с многомерным массивом

Query

-- В этом примере arrayEnumerateDenseRanked используется для получения массива, указывающего для каждого элемента
-- многомерного массива его порядковый номер среди элементов с одинаковым значением.
-- Для первой строки переданного массива [10, 10, 30, 20] соответствующая первая строка результата равна [1, 1, 2, 3]:
-- 10 — первое встреченное число (позиции 1 и 2), 30 — второе встреченное число (позиция 3),
-- 20 — третье встреченное число (позиция 4).
-- Для второй строки [40, 50, 10, 30] соответствующая вторая строка результата равна [4,5,1,2]: 40
-- и 50 — четвёртое и пятое встреченные числа (позиции 1 и 2 этой строки), ещё одно 10
-- (первое встреченное число) находится в позиции 3, а 30 (второе встреченное число) — в последней позиции.

SELECT arrayEnumerateDenseRanked(1,[[10,10,30,20],[40,50,10,30]],2);

Response

[[1,1,2,3],[4,5,1,2]]

Пример с увеличенным значением clear_depth

Query

-- При clear_depth=2 перечисление выполняется заново отдельно для каждой строки.

SELECT arrayEnumerateDenseRanked(2,[[10,10,30,20],[40,50,10,30]],2);

Response

[[1, 1, 2, 3], [1, 2, 3, 4]]

arrayEnumerateUniq

Добавленный в: v1.1.0 Возвращает массив того же размера, что и исходный, где для каждого элемента указана его позиция среди элементов с тем же значением. Эта функция полезна при использовании ARRAY JOIN и агрегации элементов массива. Функция может принимать в качестве аргументов несколько массивов одинакового размера. В этом случае уникальность определяется для кортежей элементов, находящихся на одинаковых позициях во всех массивах. Синтаксис

arrayEnumerateUniq(arr1[, arr2, ... , arrN])

Аргументы

arr1 — Первый массив для обработки. Array(T)
arr2, ... — Необязательно. Дополнительные массивы того же размера для обеспечения уникальности кортежей. Array(UInt32)

Возвращаемое значение Возвращает массив, в котором каждый элемент — это порядковый номер среди элементов с тем же значением или тем же кортежем. Array(T) Примеры Базовое использование

Query

SELECT arrayEnumerateUniq([10, 20, 10, 30]);

Response

[1, 1, 2, 1]

Несколько массивов

Query

SELECT arrayEnumerateUniq([1, 1, 1, 2, 2, 2], [1, 1, 2, 1, 1, 2]);

Response

[1,2,1,1,2,1]

Агрегация ARRAY JOIN

Query

-- Для каждого идентификатора цели вычисляется количество конверсий (каждый элемент вложенной структуры данных Goals является достигнутой целью, которую мы называем конверсией)
-- и количество сеансов. Без ARRAY JOIN количество сеансов считалось бы как sum(Sign). Однако в данном случае
-- строки были умножены на вложенную структуру Goals, поэтому чтобы учесть каждый сеанс ровно один раз, применяется условие на
-- значение функции arrayEnumerateUniq(Goals.ID).

SELECT
    Goals.ID AS GoalID,
    sum(Sign) AS Reaches,
    sumIf(Sign, num = 1) AS Visits
FROM test.visits
ARRAY JOIN
    Goals,
    arrayEnumerateUniq(Goals.ID) AS num
WHERE CounterID = 160656
GROUP BY GoalID
ORDER BY Reaches DESC
LIMIT 10

Response

┌──GoalID─┬─Reaches─┬─Visits─┐
│   53225 │    3214 │   1097 │
│ 2825062 │    3188 │   1097 │
│   56600 │    2803 │    488 │
│ 1989037 │    2401 │    365 │
│ 2830064 │    2396 │    910 │
│ 1113562 │    2372 │    373 │
│ 3270895 │    2262 │    812 │
│ 1084657 │    2262 │    345 │
│   56599 │    2260 │    799 │
│ 3271094 │    2256 │    812 │
└─────────┴─────────┴────────┘

arrayEnumerateUniqRanked

Добавленный в: v20.1.0 Возвращает массив (или многомерный массив) той же размерности, что и исходный массив, где для каждого элемента указана его позиция среди элементов с тем же значением. Позволяет выполнять нумерацию многомерного массива с возможностью указать, на какую глубину просматривать массив. Синтаксис

arrayEnumerateUniqRanked(clear_depth, arr, max_array_depth)

Аргументы

clear_depth — Отдельно нумерует элементы на указанном уровне. Положительное целое число, меньшее или равное max_arr_depth. UInt*
arr — N-мерный массив, элементы которого нужно пронумеровать. Array(T)
max_array_depth — Максимальная эффективная глубина. Положительное целое число, меньшее или равное глубине arr. UInt*

Возвращаемое значение Возвращает N-мерный массив того же размера, что и arr, где каждый элемент показывает порядковый номер данного элемента среди других элементов с тем же значением. Array(T) Примеры Пример 1

Query

-- При clear_depth=1 и max_array_depth=1 результат arrayEnumerateUniqRanked
-- совпадает с результатом, который вернул бы arrayEnumerateUniq для того же массива.

SELECT arrayEnumerateUniqRanked(1, [1, 2, 1], 1);

Response

[1, 1, 2]

Пример 2

Query

-- При clear_depth=1 и max_array_depth=1 результат arrayEnumerateUniqRanked
-- идентичен результату, который дал бы arrayEnumerateUniq для того же массива.

SELECT arrayEnumerateUniqRanked(1, [[1, 2, 3], [2, 2, 1], [3]], 2);", "[[1, 1, 1], [2, 3, 2], [2]]

Response

[1, 1, 2]

Пример 3

Query

-- В этом примере arrayEnumerateUniqRanked используется для получения массива, указывающего,
-- для каждого элемента многомерного массива, какова его позиция среди элементов
-- с тем же значением. Для первой строки переданного массива [1, 2, 3] соответствующий
-- результат равен [1, 1, 1]: значения 1, 2 и 3 встречаются впервые.
-- Для второй строки переданного массива [2, 2, 1] соответствующий результат равен [2, 3, 3]:
-- значение 2 встречается второй и третий раз, а 1 — второй раз.
-- Аналогично, для третьей строки переданного массива [3]
-- соответствующий результат равен [2]: значение 3 встречается второй раз.

SELECT arrayEnumerateUniqRanked(1, [[1, 2, 3], [2, 2, 1], [3]], 2);

Response

[[1, 1, 1], [2, 3, 2], [2]]

Пример 4

Query

-- При clear_depth=2 элементы перечисляются отдельно для каждой строки.
SELECT arrayEnumerateUniqRanked(2,[[1, 2, 3],[2, 2, 1],[3]], 2);

Response

[[1, 1, 1], [1, 2, 1], [1]]

arrayExcept

Добавленный в: v25.9.0 Возвращает массив, содержащий элементы из source, которых нет в except, с сохранением исходного порядка. Эта функция выполняет операцию разности множеств между двумя массивами. Для каждого элемента в source она проверяет, есть ли этот элемент в except (с использованием точного сравнения). Если нет, элемент включается в результат. Операция сохраняет следующие свойства:

Порядок элементов из source сохраняется
Дубликаты в source сохраняются, если их нет в except
NULL обрабатывается как отдельное значение

Синтаксис

arrayExcept(source, except)

Аргументы

source — Исходный массив, содержащий элементы для фильтрации. Array(T)
except — Массив, содержащий элементы, которые нужно исключить из результата. Array(T)

Возвращаемое значение Возвращает массив того же типа, что и входной массив, содержащий элементы из source, отсутствующие в except. Array(T) Примеры базовый

Query

SELECT arrayExcept([1, 2, 3, 2, 4], [3, 5])

Response

[1, 2, 2, 4]

with_nulls1

Query

SELECT arrayExcept([1, NULL, 2, NULL], [2])

Response

[1, NULL, NULL]

with_nulls2

Query

SELECT arrayExcept([1, NULL, 2, NULL], [NULL, 2, NULL])

Response

[1]

строки

Query

SELECT arrayExcept(['apple', 'banana', 'cherry'], ['banana', 'date'])

Response

['apple', 'cherry']

arrayExists

Добавленный в: v1.1.0 Возвращает 1, если в исходном массиве есть хотя бы один элемент, для которого func(x[, y1, y2, ... yN]) возвращает истину. В противном случае возвращает 0. Синтаксис

arrayExists(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, которая применяется к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, которые передают лямбда-функции дополнительные аргументы. Array(T)

Возвращаемое значение Возвращает 1, если лямбда-функция возвращает true хотя бы для одного элемента, иначе — 0 UInt8 Примеры Пример использования

Query

SELECT arrayExists(x, y -> x=y, [1, 2, 3], [0, 0, 0])

Response

arrayFill

Добавленный в: v20.1.0 Функция arrayFill последовательно обрабатывает исходный массив от первого элемента до последнего, вычисляя лямбда-условие для каждой позиции с использованием элементов из исходного массива и массивов условий. Если лямбда-функция возвращает false в позиции i, функция заменяет этот элемент элементом из позиции i-1 в текущем состоянии массива. Первый элемент всегда сохраняется независимо от условия. Синтаксис

arrayFill(func(x [, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x [, y1, ..., yN]) — лямбда-функция func(x [, y1, y2, ... yN]) → F(x [, y1, y2, ... yN]), которая применяется к элементам исходного массива (x) и условных массивов (y). Лямбда-функция
source_arr — исходный массив для обработки. Лямбда-функция
[, cond1_arr, ... , condN_arr] — Необязательно. N условных массивов, которые передают дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает массив Array(T) Примеры Пример с одним массивом

Query

SELECT arrayFill(x -> not isNull(x), [1, null, 2, null]) AS res

Response

[1, 1, 2, 2]

Пример с двумя массивами

Query

SELECT arrayFill(x, y, z -> x > y AND x < z, [5, 3, 6, 2], [4, 7, 1, 3], [10, 2, 8, 5]) AS res

Response

[5, 5, 6, 6]

arrayFilter

Добавленный в: v1.1.0 Возвращает массив, содержащий только те элементы исходного массива, для которых лямбда-функция возвращает true. Синтаксис

arrayFilter(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])]

Аргументы

func(x[, y1, ..., yN]) — лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — исходный массив для обработки. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает подмножество исходного массива Array(T) Примеры Пример 1

Query

SELECT arrayFilter(x -> x LIKE '%World%', ['Hello', 'abc World']) AS res

Response

['abc World']

Пример 2

Query

SELECT
    arrayFilter(
        (i, x) -> x LIKE '%World%',
        arrayEnumerate(arr),
        ['Hello', 'abc World'] AS arr)
    AS res

Response

[2]

arrayFirst

Добавленный в: v1.1.0 Возвращает первый элемент исходного массива, для которого func(x[, y1, y2, ... yN]) возвращает true; в противном случае возвращает значение по умолчанию. Синтаксис

arrayFirst(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция. - source_arr — Исходный массив для обработки. Array(T). - [, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T).

Возвращаемое значение Возвращает первый элемент исходного массива, для которого λ истинна; в противном случае возвращает значение по умолчанию для T. Примеры Пример использования

Query

SELECT arrayFirst(x, y -> x=y, ['a', 'b', 'c'], ['c', 'b', 'a'])

Response

Нет совпадений

Query

SELECT arrayFirst(x, y -> x=y, [0, 1, 2], [3, 3, 3]) AS res, toTypeName(res)

Response

0 UInt8

arrayFirstIndex

Добавленный в: v1.1.0 Возвращает индекс первого элемента в исходном массиве, для которого func(x[, y1, y2, ... yN]) возвращает true; в противном случае возвращает ‘0’. Синтаксис

arrayFirstIndex(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция. - source_arr — Исходный массив, который нужно обработать. Array(T). - [, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T).

Возвращаемое значение Возвращает индекс первого элемента исходного массива, для которого func возвращает true, в противном случае возвращает 0 UInt32 Примеры Пример использования

Query

SELECT arrayFirstIndex(x, y -> x=y, ['a', 'b', 'c'], ['c', 'b', 'a'])

Response

Нет совпадений

Query

SELECT arrayFirstIndex(x, y -> x=y, ['a', 'b', 'c'], ['d', 'e', 'f'])

Response

arrayFirstOrNull

Добавленный в: v1.1.0 Возвращает первый элемент исходного массива, для которого func(x[, y1, y2, ... yN]) возвращает true; в противном случае возвращает NULL. Синтаксис

arrayFirstOrNull(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив, который нужно обработать. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает первый элемент исходного массива, для которого func возвращает true; в противном случае возвращает NULL. Примеры Пример использования

Query

SELECT arrayFirstOrNull(x, y -> x=y, ['a', 'b', 'c'], ['c', 'b', 'a'])

Response

Совпадений не найдено

Query

SELECT arrayFirstOrNull(x, y -> x=y, [0, 1, 2], [3, 3, 3]) AS res, toTypeName(res)

Response

NULL Nullable(UInt8)

arrayFlatten

Добавленный в: v20.1.0 Преобразует массив массивов в плоский массив. Функция:

Работает с вложенными массивами любой глубины.
Не изменяет массивы, которые уже являются плоскими.

Полученный плоский массив содержит все элементы из всех исходных массивов. Синтаксис

arrayFlatten(arr)

Псевдонимы: flatten Аргументы

arr — Многомерный массив. Array(Array(T))

Возвращаемое значение Возвращает плоский массив, полученный из многомерного массива Array(T) Примеры Пример использования

Query

SELECT arrayFlatten([[[1]], [[2], [3]]]);

Response

[1, 2, 3]

arrayFold

Добавленный в: v23.10.0 Применяет лямбда-функцию к одному или нескольким массивам одинаковой длины и накапливает результат в аккумуляторе. Синтаксис

arrayFold(λ(acc, x1 [, x2, x3, ... xN]), arr1 [, arr2, arr3, ... arrN], acc)

Аргументы

λ(x, x1 [, x2, x3, ... xN]) — Лямбда-функция λ(acc, x1 [, x2, x3, ... xN]) → F(acc, x1 [, x2, x3, ... xN]), где F — операция, применяемая к acc и значениям массива x, а затем результат снова используется как acc. Лямбда-функция
arr1 [, arr2, arr3, ... arrN] — N массивов, над которыми выполняется операция. Array(T)
acc — Значение аккумулятора того же типа, что и возвращаемое значение лямбда-функции.

Возвращаемое значение Возвращает итоговое значение acc. Примеры Пример использования

Query

SELECT arrayFold(acc,x -> acc + x*2, [1, 2, 3, 4], 3::Int64) AS res;

Response

Последовательность Фибоначчи

Query

SELECT arrayFold(acc, x -> (acc.2, acc.2 + acc.1),range(number),(1::Int64, 0::Int64)).1 AS fibonacci FROM numbers(1,10);

Response

┌─fibonacci─┐
│         0 │
│         1 │
│         1 │
│         2 │
│         3 │
│         5 │
│         8 │
│        13 │
│        21 │
│        34 │
└───────────┘

Пример использования нескольких массивов

Query

SELECT arrayFold(
(acc, x, y) -> acc + (x * y),
[1, 2, 3, 4],
[10, 20, 30, 40],
0::Int64
) AS res;

Response

arrayIntersect

Добавленный в: v1.1.0 Принимает несколько массивов и возвращает массив с элементами, которые присутствуют во всех исходных массивах. Результат содержит только уникальные значения. Синтаксис

arrayIntersect(arr, arr1, ..., arrN)

Аргументы

arrN — N массивов, из которых составляется новый массив. Array(T).

Возвращаемое значение Возвращает массив с уникальными элементами, присутствующими во всех N массивах Array(T) Примеры Пример использования

Query

SELECT
arrayIntersect([1, 2], [1, 3], [2, 3]) AS empty_intersection,
arrayIntersect([1, 2], [1, 3], [1, 4]) AS non_empty_intersection

Response

┌─empty_intersection─┬─non_empty_intersection─┐
│ []                 │ [1]                    │
└────────────────────┴────────────────────────┘

arrayJaccardIndex

Добавленный в: v23.7.0 Возвращает индекс Жаккара двух массивов. Синтаксис

arrayJaccardIndex(arr_x, arr_y)

Аргументы

arr_x — Первый массив. Array(T)
arr_y — Второй массив. Array(T)

Возвращаемое значение Возвращает индекс Жаккара массивов arr_x и arr_y Float64 Примеры Пример использования

Query

SELECT arrayJaccardIndex([1, 2], [2, 3]) AS res

Response

0.3333333333333333

arrayJoin

Добавленный в: v1.1.0 Функция arrayJoin принимает строку, содержащую массив, и разворачивает его, создавая несколько строк — по одной для каждого элемента массива. Это отличается от обычных функций в ClickHouse, которые сопоставляют входные значения выходным в пределах одной и той же строки, и агрегатных функций, которые берут группу строк и “сжимают” или “сводят” их в одну итоговую строку (или в одно значение в итоговой строке, если используются с GROUP BY). Все значения в столбцах просто копируются, за исключением значений в столбце, к которому применяется эта функция; они заменяются соответствующим значением массива. Синтаксис

arrayJoin(arr)

Псевдонимы: unnest Аргументы

arr — Массив, который нужно развернуть. Array(T)

Возвращаемое значение Возвращает набор строк, полученных при разворачивании arr. Примеры Базовое использование

Query

SELECT arrayJoin([1, 2, 3] AS src) AS dst, 'Hello', src

Response

┌─dst─┬─\'Hello\'─┬─src─────┐
│   1 │ Hello     │ [1,2,3] │
│   2 │ Hello     │ [1,2,3] │
│   3 │ Hello     │ [1,2,3] │
└─────┴───────────┴─────────┘

arrayJoin влияет на все части запроса

Query

-- Функция arrayJoin влияет на все секции запроса, включая секцию WHERE. Обратите внимание: результат равен 2, хотя подзапрос вернул 1 строку.

SELECT sum(1) AS impressions
FROM
(
    SELECT ['Istanbul', 'Berlin', 'Bobruisk'] AS cities
)
WHERE arrayJoin(cities) IN ['Istanbul', 'Berlin'];

Response

┌─impressions─┐
│           2 │
└─────────────┘

Использование нескольких вызовов функции arrayJoin

Query

- В запросе можно использовать несколько функций arrayJoin. В этом случае преобразование выполняется несколько раз, а строки перемножаются.

SELECT
    sum(1) AS impressions,
    arrayJoin(cities) AS city,
    arrayJoin(browsers) AS browser
FROM
(
    SELECT
        ['Istanbul', 'Berlin', 'Bobruisk'] AS cities,
        ['Firefox', 'Chrome', 'Chrome'] AS browsers
)
GROUP BY
    2,
    3

Response

┌─impressions─┬─city─────┬─browser─┐
│           2 │ Istanbul │ Chrome  │
│           1 │ Istanbul │ Firefox │
│           2 │ Berlin   │ Chrome  │
│           1 │ Berlin   │ Firefox │
│           2 │ Bobruisk │ Chrome  │
│           1 │ Bobruisk │ Firefox │
└─────────────┴──────────┴─────────┘

Неожиданные результаты из-за оптимизации

Query

-- Использование нескольких arrayJoin с одним и тем же выражением может не дать ожидаемого результата из-за оптимизаций.
-- В таких случаях рекомендуется изменить повторяющееся выражение массива, добавив дополнительные операции, не влияющие на результат JOIN.
- e.g. arrayJoin(arraySort(arr)), arrayJoin(arrayConcat(arr, []))

SELECT
    arrayJoin(dice) as first_throw,
    /* arrayJoin(dice) as second_throw */ -- технически корректно, но уничтожит результирующий набор
    arrayJoin(arrayConcat(dice, [])) as second_throw -- выражение намеренно изменено для принудительного повторного вычисления
FROM (
    SELECT [1, 2, 3, 4, 5, 6] as dice
);

Response

┌─first_throw─┬─second_throw─┐
│           1 │            1 │
│           1 │            2 │
│           1 │            3 │
│           1 │            4 │
│           1 │            5 │
│           1 │            6 │
│           2 │            1 │
│           2 │            2 │
│           2 │            3 │
│           2 │            4 │
│           2 │            5 │
│           2 │            6 │
│           3 │            1 │
│           3 │            2 │
│           3 │            3 │
│           3 │            4 │
│           3 │            5 │
│           3 │            6 │
│           4 │            1 │
│           4 │            2 │
│           4 │            3 │
│           4 │            4 │
│           4 │            5 │
│           4 │            6 │
│           5 │            1 │
│           5 │            2 │
│           5 │            3 │
│           5 │            4 │
│           5 │            5 │
│           5 │            6 │
│           6 │            1 │
│           6 │            2 │
│           6 │            3 │
│           6 │            4 │
│           6 │            5 │
│           6 │            6 │
└─────────────┴──────────────┘

Использование синтаксиса ARRAY JOIN

Query

-- Обратите внимание на синтаксис ARRAY JOIN в запросе `SELECT` ниже — он открывает более широкие возможности.
-- ARRAY JOIN позволяет одновременно преобразовывать несколько массивов с одинаковым количеством элементов.

SELECT
    sum(1) AS impressions,
    city,
    browser
FROM
(
    SELECT
        ['Istanbul', 'Berlin', 'Bobruisk'] AS cities,
        ['Firefox', 'Chrome', 'Chrome'] AS browsers
)
ARRAY JOIN
    cities AS city,
    browsers AS browser
GROUP BY
    2,
    3

Response

┌─impressions─┬─city─────┬─browser─┐
│           1 │ Istanbul │ Firefox │
│           1 │ Berlin   │ Chrome  │
│           1 │ Bobruisk │ Chrome  │
└─────────────┴──────────┴─────────┘

Использование типа Tuple

Query

-- Также можно использовать Tuple

SELECT
    sum(1) AS impressions,
    (arrayJoin(arrayZip(cities, browsers)) AS t).1 AS city,
    t.2 AS browser
FROM
(
    SELECT
        ['Istanbul', 'Berlin', 'Bobruisk'] AS cities,
        ['Firefox', 'Chrome', 'Chrome'] AS browsers
)
GROUP BY
    2,
    3

Response

┌─impressions─┬─city─────┬─browser─┐
│           1 │ Istanbul │ Firefox │
│           1 │ Berlin   │ Chrome  │
│           1 │ Bobruisk │ Chrome  │
└─────────────┴──────────┴─────────┘

arrayLast

Добавленный в: v1.1.0 Возвращает последний элемент исходного массива, для которого лямбда func(x [, y1, y2, ... yN]) возвращает true; в противном случае возвращает значение по умолчанию. Синтаксис

arrayLast(func(x[, y1, ..., yN]), source[, cond1, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция. - source — Исходный массив, который нужно обработать. Array(T). - [, cond1, ... , condN] — Необязательно. N массивов условий, передающих лямбда-функции дополнительные аргументы. Array(T).

Возвращаемое значение Возвращает последний элемент исходного массива, для которого func возвращает true; в противном случае возвращает значение по умолчанию для T. Примеры Пример использования

Query

SELECT arrayLast(x, y -> x=y, ['a', 'b', 'c'], ['a', 'b', 'c'])

Response

Нет совпадений

Query

SELECT arrayFirst(x, y -> x=y, [0, 1, 2], [3, 3, 3]) AS res, toTypeName(res)

Response

0 UInt8

arrayLastIndex

Добавленный в: v1.1.0 Возвращает индекс последнего элемента в исходном массиве, для которого func(x[, y1, y2, ... yN]) возвращает true; в противном случае возвращает ‘0’. Синтаксис

arrayLastIndex(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, которая применяется к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, которые передают дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает индекс последнего элемента исходного массива, для которого func возвращает true; в противном случае возвращает 0 UInt32 Примеры Пример использования

Query

SELECT arrayLastIndex(x, y -> x=y, ['a', 'b', 'c'], ['a', 'b', 'c']);

Response

Совпадений нет

Query

SELECT arrayLastIndex(x, y -> x=y, ['a', 'b', 'c'], ['d', 'e', 'f']);

Response

arrayLastOrNull

Добавленный в: v1.1.0 Возвращает последний элемент исходного массива, для которого лямбда-функция func(x [, y1, y2, ... yN]) возвращает true; в противном случае возвращает NULL. Синтаксис

arrayLastOrNull(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x [, y1, ..., yN]) — лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция. - source_arr — исходный массив для обработки. Array(T). - [, cond1_arr, ... , condN_arr] — необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T).

Возвращаемое значение Возвращает последний элемент исходного массива, для которого λ ложно; в противном случае возвращает NULL. Примеры Пример использования

Query

SELECT arrayLastOrNull(x, y -> x=y, ['a', 'b', 'c'], ['a', 'b', 'c'])

Response

Совпадений нет

Query

SELECT arrayLastOrNull(x, y -> x=y, [0, 1, 2], [3, 3, 3]) AS res, toTypeName(res)

Response

NULL Nullable(UInt8)

arrayLevenshteinDistance

Добавленный в: v25.4.0 Вычисляет расстояние Левенштейна между двумя массивами. Синтаксис

arrayLevenshteinDistance(from, to)

Аргументы

from — Первый массив. Array(T). - to — Второй массив. Array(T).

Возвращаемое значение Расстояние Левенштейна между первым и вторым массивами. Float64 Примеры Пример использования

Query

SELECT arrayLevenshteinDistance([1, 2, 4], [1, 2, 3])

Response

arrayLevenshteinDistanceWeighted

Добавленный в: v25.4.0 Вычисляет расстояние Левенштейна между двумя массивами с пользовательскими весами для каждого элемента. Количество элементов в массиве и количество соответствующих весов должны совпадать. Синтаксис

arrayLevenshteinDistanceWeighted(from, to, from_weights, to_weights)

Аргументы

from — первый массив. Array(T). - to — второй массив. Array(T). - from_weights — веса первого массива. Array((U)Int*|Float*)
to_weights — веса второго массива. Array((U)Int*|Float*)

Возвращаемое значение Расстояние Левенштейна между первым и вторым массивами с заданными весами для каждого элемента Float64 Примеры Пример использования

Query

SELECT arrayLevenshteinDistanceWeighted(['A', 'B', 'C'], ['A', 'K', 'L'], [1.0, 2, 3], [3.0, 4, 5])

Response

arrayMap

Добавленный в: v1.1.0 Возвращает массив, полученный из исходных массивов путём применения лямбда-функции к каждому элементу. Синтаксис

arrayMap(func, arr)

Аргументы

func — Лямбда-функция, которая применяется к элементам исходного массива (x) и условных массивов (y). Лямбда-функция
arr — N массивов для обработки. Array(T)

Возвращаемое значение Возвращает массив результатов лямбда-функции Array(T) Примеры Пример использования

Query

SELECT arrayMap(x -> (x + 2), [1, 2, 3]) as res;

Response

[3, 4, 5]

Создание кортежа из элементов разных массивов

Query

SELECT arrayMap((x, y) -> (x, y), [1, 2, 3], [4, 5, 6]) AS res

Response

[(1, 4),(2, 5),(3, 6)]

arrayMax

Добавленный в: v21.1.0 Возвращает максимальный элемент исходного массива. Если указана лямбда-функция func, возвращает максимальный элемент среди результатов лямбда-функции. Синтаксис

arrayMax([func(x[, y1, ..., yN])], source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Необязательно. Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает максимальный элемент исходного массива или, если указана лямбда-функция, максимальный элемент среди результатов её применения. Примеры Базовый пример

Query

SELECT arrayMax([5, 3, 2, 7]);

Response

Использование с лямбда-функцией

Query

SELECT arrayMax(x, y -> x/y, [4, 8, 12, 16], [1, 2, 1, 2]);

Response

arrayMin

Добавленный в: v21.1.0 Возвращает минимальный элемент исходного массива. Если указана лямбда-функция func, возвращает минимальный элемент среди результатов её выполнения. Синтаксис

arrayMin([func(x[, y1, ..., yN])], source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Необязательно. Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
cond1_arr, ... — Необязательно. N массивов условий, передающих в лямбда-функцию дополнительные аргументы. Array(T)

Возвращаемое значение Возвращает минимальный элемент исходного массива или, если указана лямбда-функция, минимальный элемент среди её результатов. Примеры Базовый пример

Query

SELECT arrayMin([5, 3, 2, 7]);

Response

Использование с лямбда-функцией

Query

SELECT arrayMin(x, y -> x/y, [4, 8, 12, 16], [1, 2, 1, 2]);

Response

arrayNormalizedGini

Добавлено в: v25.1.0 Вычисляет нормализованный коэффициент Джини. Синтаксис

arrayNormalizedGini(predicted, label)

Аргументы

predicted — Предсказанное значение. Array(T)
label — Фактическое значение. Array(T)

Возвращаемое значение Кортеж, содержащий коэффициент Джини для предсказанных значений, коэффициент Джини для нормализованных значений и нормализованный коэффициент Джини (= отношение первых двух коэффициентов Джини) Tuple(Float64, Float64, Float64) Примеры Пример использования

Query

SELECT arrayNormalizedGini([0.9, 0.3, 0.8, 0.7],[6, 1, 0, 2]);

Response

(0.18055555555555558, 0.2638888888888889, 0.6842105263157896)

arrayPartialReverseSort

Добавленный в: v23.2.0 Эта функция аналогична arrayReverseSort, но с дополнительным аргументом limit, который позволяет выполнять частичную сортировку.

Чтобы сохранить только отсортированные элементы, используйте arrayResize.

Синтаксис

arrayPartialReverseSort([f,] arr [, arr1, ... ,arrN], limit)

Аргументы

f(arr[, arr1, ... ,arrN]) — Лямбда-функция, применяемая к элементам массива arr. Лямбда-функция
arr — Массив для сортировки. Array(T)
arr1, ... ,arrN — N дополнительных массивов, если f принимает несколько аргументов. Array(T)
limit — Значение индекса, до которого выполняется сортировка. (U)Int*

Возвращаемое значение Возвращает массив того же размера, что и исходный, в котором элементы в диапазоне [1..limit] отсортированы в порядке убывания. Остальные элементы (limit..N] находятся в неопределённом порядке. Примеры simple_int

Query

SELECT arrayPartialReverseSort(2, [5, 9, 1, 3])

Response

[9, 5, 1, 3]

simple_string

Query

SELECT arrayPartialReverseSort(2, ['expenses','lasso','embolism','gladly'])

Response

['lasso','gladly','expenses','embolism']

retain_sorted

Query

SELECT arrayResize(arrayPartialReverseSort(2, [5, 9, 1, 3]), 2)

Response

[9, 5]

lambda_simple

Query

SELECT arrayPartialReverseSort((x) -> -x, 2, [5, 9, 1, 3])

Response

[1, 3, 5, 9]

lambda_complex

Query

SELECT arrayPartialReverseSort((x, y) -> -y, 1, [0, 1, 2], [1, 2, 3]) as res

Response

[0, 1, 2]

arrayPartialShuffle

Добавленный в: v23.2.0 Возвращает массив того же размера, что и исходный, где элементы в диапазоне [1..limit] представляют собой случайное подмножество исходного массива. Оставшаяся часть (limit..n] содержит элементы, не входящие в диапазон [1..limit], в неопределённом порядке. Значение limit должно находиться в диапазоне [1..n]. Значения вне этого диапазона эквивалентны полному arrayShuffle:

Эта функция не материализует константы.Значение limit должно находиться в диапазоне [1..N]. Значения вне этого диапазона эквивалентны полному arrayShuffle.

Синтаксис

arrayPartialShuffle(arr [, limit[, seed]])

Аргументы

arr — Массив, который нужно перемешать. Array(T)
seed — Необязательно. Seed, используемый при генерации случайных чисел. Если не указан, используется случайное значение. (U)Int*
limit — Необязательно. Число, ограничивающее количество перестановок элементов, в диапазоне [1..N]. (U)Int*

Возвращаемое значение Массив с частично перемешанными элементами. Array(T) Примеры no_limit1

Query

SELECT arrayPartialShuffle([1, 2, 3, 4], 0)

Response

[2, 4, 3, 1]

no_limit2

Query

SELECT arrayPartialShuffle([1, 2, 3, 4])

Response

[4, 1, 3, 2]

random_seed

Query

SELECT arrayPartialShuffle([1, 2, 3, 4], 2)

Response

[3, 4, 1, 2]

explicit_seed

Query

SELECT arrayPartialShuffle([1, 2, 3, 4], 2, 41)

Response

[3, 2, 1, 4]

материализовать

Query

SELECT arrayPartialShuffle(materialize([1, 2, 3, 4]), 2, 42), arrayPartialShuffle([1, 2, 3], 2, 42) FROM numbers(10)

Response

┌─arrayPartial⋯4]), 2, 42)─┬─arrayPartial⋯ 3], 2, 42)─┐
│ [3,2,1,4]                │ [3,2,1]                  │
│ [3,2,1,4]                │ [3,2,1]                  │
│ [4,3,2,1]                │ [3,2,1]                  │
│ [1,4,3,2]                │ [3,2,1]                  │
│ [3,4,1,2]                │ [3,2,1]                  │
│ [1,2,3,4]                │ [3,2,1]                  │
│ [1,4,3,2]                │ [3,2,1]                  │
│ [1,4,3,2]                │ [3,2,1]                  │
│ [3,1,2,4]                │ [3,2,1]                  │
│ [1,3,2,4]                │ [3,2,1]                  │
└──────────────────────────┴──────────────────────────┘

arrayPartialSort

Добавленный в: v23.2.0 Эта функция аналогична arraySort, но с дополнительным аргументом limit, который позволяет выполнять частичную сортировку.

Чтобы сохранить только отсортированные элементы, используйте arrayResize.

Синтаксис

arrayPartialSort([f,] arr [, arr1, ... ,arrN], limit)

Аргументы

f(arr[, arr1, ... ,arrN]) — Лямбда-функция, применяемая к элементам массива x. Лямбда-функция
arr — Массив, который нужно отсортировать. Array(T)
arr1, ... ,arrN — N дополнительных массивов, если f принимает несколько аргументов. Array(T)
limit — Значение индекса, до которого будет выполняться сортировка. (U)Int*

Возвращаемое значение Возвращает массив того же размера, что и исходный, в котором элементы в диапазоне [1..limit] отсортированы по возрастанию. Остальные элементы (limit..N] находятся в неопределённом порядке. Примеры simple_int

Query

SELECT arrayPartialSort(2, [5, 9, 1, 3])

Response

[1, 3, 5, 9]

simple_string

Query

SELECT arrayPartialSort(2, ['expenses', 'lasso', 'embolism', 'gladly'])

Response

['embolism', 'expenses', 'gladly', 'lasso']

retain_sorted

Query

SELECT arrayResize(arrayPartialSort(2, [5, 9, 1, 3]), 2)

Response

[1, 3]

lambda_simple

Query

SELECT arrayPartialSort((x) -> -x, 2, [5, 9, 1, 3])

Response

[9, 5, 1, 3]

lambda_complex

Query

SELECT arrayPartialSort((x, y) -> -y, 1, [0, 1, 2], [1, 2, 3]) as res

Response

[2, 1, 0]

arrayPopBack

Добавленный в: v1.1.0 Удаляет последний элемент массива. Синтаксис

arrayPopBack(arr)

Аргументы

arr — Массив, из которого нужно удалить последний элемент. Array(T)

Возвращаемое значение Возвращает массив, совпадающий с arr, но без его последнего элемента Array(T) Примеры Пример использования

Query

SELECT arrayPopBack([1, 2, 3]) AS res;

Response

[1, 2]

arrayPopFront

Добавленный в: v1.1.0 Удаляет первый элемент массива. Синтаксис

arrayPopFront(arr)

Аргументы

arr — массив, из которого нужно удалить первый элемент. Array(T)

Возвращаемое значение Возвращает массив, идентичный arr, но без его первого элемента Array(T) Примеры Пример использования

Query

SELECT arrayPopFront([1, 2, 3]) AS res;

Response

[2, 3]

arrayProduct

Добавленный в: v21.1.0 Возвращает произведение элементов исходного массива. Если указана лямбда-функция func, возвращает произведение результатов лямбда-функции для элементов массива. Синтаксис

arrayProduct([func(x[, y1, ..., yN])], source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Необязательно. Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, передающих дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает произведение элементов исходного массива или, если указана лямбда-функция, произведение результатов её применения к элементам. Float64 Примеры Базовый пример

Query

SELECT arrayProduct([1, 2, 3, 4]);

Response

Использование с лямбда-функцией

Query

SELECT arrayProduct(x, y -> x+y, [2, 2], [2, 2]) AS res;

Response

arrayPushBack

Добавленный в: v1.1.0 Добавляет один элемент в конец массива. Синтаксис

arrayPushBack(arr, x)

Аргументы

arr — Массив, в конец которого добавляется значение x. Array(T)
x —
Одно значение, добавляемое в конец массива. Array(T).

В массив чисел можно добавлять только числа, а в массив строк — только строки.
При добавлении чисел ClickHouse автоматически приводит тип x к типу данных массива.
Может быть NULL. Функция добавляет в массив элемент NULL, а тип элементов массива преобразуется в Nullable.

Дополнительные сведения о типах данных в ClickHouse см. в разделе Типы данных.

Возвращаемое значение Возвращает массив, идентичный arr, но с дополнительным значением x в конце Array(T) Примеры Пример использования

Query

SELECT arrayPushBack(['a'], 'b') AS res;

Response

['a','b']

arrayPushFront

Добавленный в: v1.1.0 Добавляет один элемент в начало массива. Синтаксис

arrayPushFront(arr, x)

Аргументы

arr — Массив, в конец которого добавляется значение x. Array(T). - x —
Одно значение, добавляемое в начало массива. Array(T).

В массив чисел можно добавлять только числа, а в массив строк — только строки.
При добавлении чисел ClickHouse автоматически приводит тип x к типу данных массива.
Может быть NULL. Функция добавляет в массив элемент NULL, а тип элементов массива преобразуется в Nullable.

Дополнительные сведения о типах данных в ClickHouse см. в разделе Типы данных.

Возвращаемое значение Возвращает массив, идентичный arr, но с дополнительным значением x в начале массива Array(T) Примеры Пример использования

Query

SELECT arrayPushFront(['b'], 'a') AS res;

Response

['a','b']

arrayROCAUC

Добавленный в: v20.4.0 Вычисляет площадь под ROC-кривой (receiver operating characteristic). ROC-кривая строится путём откладывания True Positive Rate (TPR) по оси y и False Positive Rate (FPR) по оси x для всех порогов. Итоговое значение находится в диапазоне от нуля до единицы; чем оно выше, тем лучше качество модели. ROC AUC (также известная просто как AUC) — это понятие из области машинного обучения. Подробнее см. здесь, здесь и здесь. Синтаксис

arrayROCAUC(scores, labels[, scale[, partial_offsets]])

Псевдонимы: arrayAUC Аргументы

scores — Оценки, которые выдаёт модель. Array((U)Int*) или Array(Float*)
labels — Метки объектов, обычно 1 для положительного примера и 0 для отрицательного. Array((U)Int*) или Enum
scale — Необязательно. Определяет, нужно ли возвращать нормализованную площадь. Если false, вместо этого возвращается площадь под кривой TP (true positives) x FP (false positives). Значение по умолчанию: true. Bool
partial_offsets —
Массив из четырёх неотрицательных целых чисел для вычисления частичной площади под ROC-кривой (эквивалентной вертикальной полосе в пространстве ROC) вместо полного AUC. Эта опция полезна для распределённого вычисления ROC AUC. Массив должен содержать следующие элементы [higher_partitions_tp, higher_partitions_fp, total_positives, total_negatives]. Array из неотрицательных Integers. Необязательно.
- higher_partitions_tp: Количество положительных меток в партициях с более высокими оценками.
- higher_partitions_fp: Количество отрицательных меток в партициях с более высокими оценками.
- total_positives: Общее количество положительных примеров во всём наборе данных.
- total_negatives: Общее количество отрицательных примеров во всём наборе данных.

Когда используется arr_partial_offsets, arr_scores и arr_labels должны представлять только одну партицию всего набора данных, содержащую некоторый диапазон оценок. Набор данных следует разделить на непрерывные партиции, где каждая партиция содержит подмножество данных, оценки которых попадают в определённый диапазон. Например:

Одна партиция может содержать все оценки в диапазоне [0, 0.5).
Другая партиция может содержать оценки в диапазоне [0.5, 1.0].

Возвращаемое значение Возвращает площадь под ROC-кривой (receiver operating characteristic). Float64 Примеры Пример использования

Query

SELECT arrayROCAUC([0.1, 0.4, 0.35, 0.8], [0, 0, 1, 1]);

Response

0.75

arrayRandomSample

Добавленный в: v23.10.0 Возвращает подмножество из samples случайно выбранных элементов входного массива. Если samples превышает размер входного массива, размер выборки ограничивается размером массива, то есть возвращаются все элементы массива, но их порядок не гарантируется. Функция поддерживает как плоские, так и вложенные массивы. Синтаксис

arrayRandomSample(arr, samples)

Аргументы

arr — Входной массив или многомерный массив, из которого производится выборка элементов. Array(T)
samples — Количество элементов, которые нужно включить в случайную выборку. (U)Int*

Возвращаемое значение Массив, содержащий случайную выборку элементов из входного массива Array(T) Примеры Пример использования

Query

SELECT arrayRandomSample(['apple', 'banana', 'cherry', 'date'], 2) as res;

Response

['cherry','apple']

Использование многомерного массива

Query

SELECT arrayRandomSample([[1, 2], [3, 4], [5, 6]], 2) as res;

Response

[[3,4],[5,6]]

arrayReduce

Добавленный в: v1.1.0 Применяет агрегатную функцию к элементам массива и возвращает результат. Имя агрегатной функции передаётся в виде строки в одинарных кавычках: 'max', 'sum'. При использовании параметрических агрегатных функций параметр указывается после имени функции в круглых скобках: 'uniqUpTo(6)'. Синтаксис

arrayReduce(agg_f, arr1[, arr2, ... , arrN])

Аргументы

agg_f — имя агрегатной функции; должно быть константой. String
arr1[, arr2, ... , arrN] — N массивов, соответствующих аргументам agg_f. Array(T)

Возвращаемое значение Результат агрегатной функции Примеры Пример использования

Query

SELECT arrayReduce('max', [1, 2, 3]);

Response

┌─arrayReduce('max', [1, 2, 3])─┐
│                             3 │
└───────────────────────────────┘

Пример агрегатной функции с несколькими аргументами

Query

--Если агрегатная функция принимает несколько аргументов, она должна применяться к нескольким массивам одинакового размера.

SELECT arrayReduce('maxIf', [3, 5], [1, 0]);

Response

┌─arrayReduce('maxIf', [3, 5], [1, 0])─┐
│                                    3 │
└──────────────────────────────────────┘

Пример с параметрической агрегатной функцией

Query

SELECT arrayReduce('uniqUpTo(3)', [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);

Response

┌─arrayReduce('uniqUpTo(3)', [1, 2, 3, 4, 5, 6, 7, 8, 9, 10])─┐
│                                                           4 │
└─────────────────────────────────────────────────────────────┘

arrayReduceInRanges

Добавленный в: v20.4.0 Применяет агрегатную функцию к элементам массива в заданных диапазонах и возвращает массив с результатом для каждого диапазона. Функция вернёт тот же результат, что и несколько вызовов arrayReduce(agg_func, arraySlice(arr1, index, length), ...). Синтаксис

arrayReduceInRanges(agg_f, ranges, arr1[, arr2, ... ,arrN])

Аргументы

agg_f — Имя используемой агрегатной функции. String
ranges — Диапазон, по которому выполняется агрегирование. Массив кортежей (i, r), содержащих индекс i, с которого следует начинать, и диапазон r, по которому выполняется агрегирование. Array(T) или Tuple(T)
arr1[, arr2, ... ,arrN] — N массивов в качестве аргументов агрегатной функции. Array(T)

Возвращаемое значение Возвращает массив, содержащий результаты агрегатной функции по указанным диапазонам Array(T) Примеры Пример использования

Query

SELECT arrayReduceInRanges(
    'sum',
    [(1, 5), (2, 3), (3, 4), (4, 4)],
    [1000000, 200000, 30000, 4000, 500, 60, 7]
) AS res

Response

┌─res─────────────────────────┐
│ [1234500,234000,34560,4567] │
└─────────────────────────────┘

arrayRemove

Добавленный в: v25.11.0 Удаляет из массива все элементы, равные указанному значению. NULL считается равным NULL. Синтаксис

arrayRemove(arr, elem)

Псевдонимы: array_remove Аргументы

arr — Array(T) - elem — T

Возвращаемое значение Возвращает часть исходного массива Array(T) Примеры Пример 1

Query

SELECT arrayRemove([1, 2, 2, 3], 2)

Response

[1, 3]

Пример 2

Query

SELECT arrayRemove(['a', NULL, 'b', NULL], NULL)

Response

['a', 'b']

arrayResize

Добавлено в: v1.1.0 Изменяет длину массива. Синтаксис

arrayResize(arr, size[, extender])

Аргументы

arr — Массив, размер которого нужно изменить. Array(T)
size — -Новая длина массива. Если size меньше исходного размера массива, массив обрезается справа. Если size больше исходного размера массива, массив расширяется вправо значениями extender или значениями по умолчанию для типа данных элементов массива.
extender — Значение, используемое для расширения массива. Может быть NULL.

Возвращаемое значение Массив длиной size. Array(T) Примеры Пример 1

Query

SELECT arrayResize([1], 3);

Response

[1,0,0]

Пример 2

Query

SELECT arrayResize([1], 3, NULL);

Response

[1,NULL,NULL]

arrayReverse

Добавленный в: v1.1.0 Изменяет порядок элементов заданного массива на обратный.

Функция reverse(arr) выполняет ту же операцию, но работает и с другими типами данных, помимо массивов.

Синтаксис

arrayReverse(arr)

Аргументы

arr — Массив, который нужно развернуть. Array(T)

Возвращаемое значение Возвращает массив того же размера, что и исходный, с элементами в обратном порядке Array(T) Примеры Пример использования

Query

SELECT arrayReverse([1, 2, 3])

Response

[3,2,1]

arrayReverseFill

Добавленный в: v20.1.0 Функция arrayReverseFill последовательно обрабатывает исходный массив от последнего элемента к первому, вычисляя в каждой позиции лямбда-условие с использованием элементов из исходного массива и массивов условий. Если в позиции i условие принимает значение false, функция заменяет этот элемент элементом из позиции i+1 в текущем состоянии массива. Последний элемент всегда сохраняется независимо от условия. Синтаксис

arrayReverseFill(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, применяемая к элементам исходного массива (x) и условных массивов (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
[, cond1_arr, ... , condN_arr] — Необязательно. N условных массивов, передающих дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает массив, в котором элементы исходного массива заменены результатами лямбда-функции. Array(T) Примеры Пример с одним массивом

Query

SELECT arrayReverseFill(x -> not isNull(x), [1, null, 2, null]) AS res

Response

[1, 2, 2, NULL]

Пример с двумя массивами

Query

SELECT arrayReverseFill(x, y, z -> x > y AND x < z, [5, 3, 6, 2], [4, 7, 1, 3], [10, 2, 8, 5]) AS res;

Response

[5, 6, 6, 2]

arrayReverseSort

Добавленный в: v1.1.0 Сортирует элементы массива по убыванию. Если указана функция f, переданный массив сортируется по результату применения этой функции к элементам массива, а затем отсортированный массив переворачивается. Если f принимает несколько аргументов, в функцию arrayReverseSort передаётся несколько массивов, аргументам func будут соответствовать их элементы. Если сортируемый массив содержит -Inf, NULL, NaN или Inf, они будут отсортированы в следующем порядке:

-Inf
Inf
NaN
NULL

arrayReverseSort — это функция высшего порядка. Синтаксис

arrayReverseSort([f,] arr [, arr1, ... ,arrN)

Аргументы

f(y1[, y2 ... yN]) — лямбда-функция, применяемая к элементам массива x. - arr — массив, который нужно отсортировать. Array(T) - arr1, ..., yN — необязательно. N дополнительных массивов, если f принимает несколько аргументов.

Возвращаемое значение Возвращает массив x, отсортированный по убыванию, если лямбда-функция не указана; в противном случае возвращает массив, отсортированный в соответствии с логикой переданной лямбда-функции, а затем перевёрнутый. Array(T). Примеры Пример 1

Query

SELECT arrayReverseSort((x, y) -> y, [4, 3, 5], ['a', 'b', 'c']) AS res;

Response

[5,3,4]

Пример 2

Query

SELECT arrayReverseSort((x, y) -> -y, [4, 3, 5], [1, 2, 3]) AS res;

Response

[4,3,5]

arrayReverseSplit

Добавленный в: v20.1.0 Разбивает исходный массив на несколько массивов. Когда func(x[, y1, ..., yN]) возвращает значение, отличное от нуля, массив разбивается справа от элемента. После последнего элемента массив не разбивается. Синтаксис

arrayReverseSplit(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Лямбда-функция
[, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, предоставляющих лямбда-функции дополнительные аргументы. Array(T)

Возвращаемое значение Возвращает массив массивов. Array(Array(T)) Примеры Пример использования

Query

SELECT arrayReverseSplit((x, y) -> y, [1, 2, 3, 4, 5], [1, 0, 0, 1, 0]) AS res

Response

[[1], [2, 3, 4], [5]]

arrayRotateLeft

Добавленный в: v23.8.0 Циклически сдвигает массив влево на указанное число элементов. Отрицательные значения n интерпретируются как циклический сдвиг вправо на абсолютную величину сдвига. Синтаксис

arrayRotateLeft(arr, n)

Аргументы

arr — Массив, элементы которого нужно циклически сдвинуть.Array(T). - n — Количество элементов для циклического сдвига. (U)Int8/16/32/64.

Возвращаемое значение Массив, циклически сдвинутый влево на указанное число элементов Array(T) Примеры Пример использования

Query

SELECT arrayRotateLeft([1,2,3,4,5,6], 2) as res;

Response

[3,4,5,6,1,2]

Отрицательное значение n

Query

SELECT arrayRotateLeft([1,2,3,4,5,6], -2) as res;

Response

[5,6,1,2,3,4]

arrayRotateRight

Добавленный в: v23.8.0 Циклически сдвигает массив вправо на указанное число элементов. Отрицательные значения n трактуются как циклический сдвиг влево на абсолютную величину сдвига. Синтаксис

arrayRotateRight(arr, n)

Аргументы

arr — Массив, элементы которого нужно циклически сдвинуть.Array(T). - n — Количество элементов, на которое выполняется циклический сдвиг. (U)Int8/16/32/64.

Возвращаемое значение Массив, циклически сдвинутый вправо на указанное количество элементов Array(T) Примеры Пример использования

Query

SELECT arrayRotateRight([1,2,3,4,5,6], 2) as res;

Response

[5,6,1,2,3,4]

Отрицательное значение n

Query

SELECT arrayRotateRight([1,2,3,4,5,6], -2) as res;

Response

[3,4,5,6,1,2]

arrayShiftLeft

Добавленный в: v23.8.0 Сдвигает массив влево на указанное количество элементов. Новые элементы заполняются указанным аргументом или значением по умолчанию для типа элементов массива. Если количество элементов отрицательное, массив сдвигается вправо. Синтаксис

arrayShiftLeft(arr, n[, default])

Аргументы

arr — Массив, элементы которого нужно сдвинуть.Array(T). - n — Количество элементов, на которое нужно выполнить сдвиг.(U)Int8/16/32/64. - default — Необязательно. Значение по умолчанию для новых элементов.

Возвращаемое значение Массив, сдвинутый влево на указанное количество элементов Array(T) Примеры Пример использования

Query

SELECT arrayShiftLeft([1,2,3,4,5,6], 2) as res;

Response

[3,4,5,6,0,0]

Отрицательное значение параметра n

Query

SELECT arrayShiftLeft([1,2,3,4,5,6], -2) as res;

Response

[0,0,1,2,3,4]

Использование значения по умолчанию

Query

SELECT arrayShiftLeft([1,2,3,4,5,6], 2, 42) as res;

Response

[3,4,5,6,42,42]

arrayShiftRight

Добавленный в: v23.8.0 Сдвигает массив вправо на указанное количество элементов. Новые элементы заполняются переданным аргументом или значением по умолчанию для типа элементов массива. Если количество элементов отрицательное, массив сдвигается влево. Синтаксис

arrayShiftRight(arr, n[, default])

Аргументы

arr — Массив, элементы которого нужно сдвинуть. Array(T)
n — Количество элементов, на которое нужно выполнить сдвиг. (U)Int8/16/32/64
default — Необязательно. Значение по умолчанию для новых элементов.

Возвращаемое значение Массив, сдвинутый вправо на указанное количество элементов Array(T) Примеры Пример использования

Query

SELECT arrayShiftRight([1, 2, 3, 4, 5, 6], 2) as res;

Response

[0, 0, 1, 2, 3, 4]

Отрицательное значение n

Query

SELECT arrayShiftRight([1, 2, 3, 4, 5, 6], -2) as res;

Response

[3, 4, 5, 6, 0, 0]

Использование значения по умолчанию

Query

SELECT arrayShiftRight([1, 2, 3, 4, 5, 6], 2, 42) as res;

Response

[42, 42, 1, 2, 3, 4]

arrayShingles

Добавленный в: v24.1.0 Генерирует массив шинглов (по аналогии с n-граммами для строк), то есть последовательность подмассивов заданной длины из входного массива. Синтаксис

arrayShingles(arr, l)

Аргументы

arr — массив, для которого нужно сгенерировать массив шинглов. Array(T)
l — длина каждого шингла. (U)Int*

Возвращаемое значение Массив сгенерированных шинглов Array(T) Примеры Пример использования

Query

SELECT arrayShingles([1, 2, 3, 4], 3) as res;

Response

[[1, 2, 3], [2, 3, 4]]

arrayShuffle

Добавленный в: v23.2.0 Возвращает массив того же размера, что и исходный, с элементами в случайном порядке. Элементы переупорядочиваются так, что каждая возможная их перестановка появляется с одинаковой вероятностью.

Эта функция не материализует константы.

Синтаксис

arrayShuffle(arr [, seed])

Аргументы

arr — Массив, который нужно перемешать. Array(T)
seed (optional) — Необязательно. Значение seed, используемое для генерации случайных чисел. Если не указано, используется случайное значение. (U)Int*

Возвращаемое значение Массив с перемешанными элементами Array(T) Примеры Пример без seed (нестабильные результаты)

Query

SELECT arrayShuffle([1, 2, 3, 4]);

Response

[1,4,2,3]

Пример без seed (устойчивые результаты)

Query

SELECT arrayShuffle([1, 2, 3, 4], 41);

Response

[3,2,1,4]

arraySimilarity

Добавленный в: v25.4.0 Вычисляет степень сходства двух массивов в диапазоне от 0 до 1 на основе взвешенного расстояния Левенштейна. Синтаксис

arraySimilarity(from, to, from_weights, to_weights)

Аргументы

from — первый массив Array(T)
to — второй массив Array(T)
from_weights — веса первого массива. Array((U)Int*|Float*)
to_weights — веса второго массива. Array((U)Int*|Float*)

Возвращаемое значение Возвращает значение сходства двух массивов в диапазоне от 0 до 1, вычисленное на основе взвешенного расстояния Левенштейна Float64 Примеры Пример использования

Query

SELECT arraySimilarity(['A', 'B', 'C'], ['A', 'K', 'L'], [1.0, 2, 3], [3.0, 4, 5]);

Response

0.2222222222222222

arraySlice

Добавленный в: v1.1.0 Возвращает срез массива, включая элементы со значением NULL. Синтаксис

arraySlice(arr, offset [, length])

Аргументы

arr — Массив, из которого берётся срез. Array(T)
offset — Отступ от края массива. Положительное значение указывает на смещение слева, а отрицательное — на отступ справа. Нумерация элементов массива начинается с 1. (U)Int*
length — Длина требуемого среза. Если указать отрицательное значение, функция возвращает открытый срез [offset, array_length - length]. Если не указывать это значение, функция возвращает срез [offset, the_end_of_array]. (U)Int*

Возвращаемое значение Возвращает срез массива длиной length элементов, начиная с указанного offset Array(T) Примеры Пример использования

Query

SELECT arraySlice([1, 2, NULL, 4, 5], 2, 3) AS res;

Response

[2, NULL, 4]

arraySort

Добавленный в: v1.1.0 Сортирует элементы переданного массива по возрастанию. Если указана лямбда-функция f, порядок сортировки определяется результатом применения этой функции к каждому элементу массива. Если лямбда-функция принимает несколько аргументов, в arraySort передаётся несколько массивов, аргументам f будут соответствовать их элементы. Если сортируемый массив содержит -Inf, NULL, NaN или Inf, они будут отсортированы в следующем порядке:

-Inf
Inf
NaN
NULL

arraySort — это функция высшего порядка. Синтаксис

arraySort([f,] arr [, arr1, ... ,arrN])

Аргументы

f(y1[, y2 ... yN]) — лямбда-функция, применяемая к элементам массива x. - arr — массив, который необходимо отсортировать. Array(T) - arr1, ..., yN — Необязательно. N дополнительных массивов, если f принимает несколько аргументов.

Возвращаемое значение Возвращает массив arr, отсортированный по возрастанию, если лямбда-функция не указана; в противном случае возвращает массив, отсортированный в соответствии с логикой указанной лямбда-функции. Array(T). Примеры Пример 1

Query

SELECT arraySort([1, 3, 3, 0]);

Response

[0,1,3,3]

Пример 2

Query

SELECT arraySort(['hello', 'world', '!']);

Response

['!','hello','world']

Пример 3

Query

SELECT arraySort([1, nan, 2, NULL, 3, nan, -4, NULL, inf, -inf]);

Response

[-inf,-4,1,2,3,inf,nan,nan,NULL,NULL]

arraySplit

Добавленный в: v20.1.0 Разбивает исходный массив на несколько массивов. Если func(x [, y1, ..., yN]) возвращает значение, отличное от нуля, массив будет разделён слева от этого элемента. Массив не разделяется перед первым элементом. Синтаксис

arraySplit(func(x[, y1, ..., yN]), source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Лямбда-функция, применяемая к элементам исходного массива (x) и условных массивов (y). Лямбда-функция. - source_arr — Исходный массив, который нужно разбить Array(T). - [, cond1_arr, ... , condN_arr] — Необязательно. N условных массивов, передающих лямбда-функции дополнительные аргументы. Array(T).

Возвращаемое значение Возвращает массив массивов Array(Array(T)) Примеры Пример использования

Query

SELECT arraySplit((x, y) -> y, [1, 2, 3, 4, 5], [1, 0, 0, 1, 0]) AS res

Response

[[1, 2, 3], [4, 5]]

arraySum

Добавленный в: v21.1.0 Возвращает сумму элементов исходного массива. Если указана лямбда-функция func, возвращает сумму элементов, полученных в результате её применения. Синтаксис

arraySum([func(x[, y1, ..., yN])], source_arr[, cond1_arr, ... , condN_arr])

Аргументы

func(x[, y1, ..., yN]) — Необязательно. Лямбда-функция, применяемая к элементам исходного массива (x) и массивов условий (y). Лямбда-функция
source_arr — Исходный массив для обработки. Array(T)
, cond1_arr, ... , condN_arr] — Необязательно. N массивов условий, которые передают дополнительные аргументы в лямбда-функцию. Array(T)

Возвращаемое значение Возвращает сумму элементов исходного массива или, если указана лямбда-функция, сумму элементов результатов её применения. Примеры Базовый пример

Query

SELECT arraySum([1, 2, 3, 4]);

Response

Использование с лямбда-функцией

Query

SELECT arraySum(x, y -> x+y, [1, 1, 1, 1], [1, 1, 1, 1]);

Response

arraySymmetricDifference

Добавленный в: v25.4.0 Принимает несколько массивов и возвращает массив с элементами, которые содержатся не во всех исходных массивах. Результат содержит только уникальные значения.

Симметрическая разность более чем двух множеств математически определяется как множество всех входных элементов, которые встречаются в нечётном числе входных множеств. В отличие от этого, функция arraySymmetricDifference просто возвращает множество входных элементов, которые содержатся не во всех входных множествах.

Синтаксис

arraySymmetricDifference(arr1, arr2, ... , arrN)

Аргументы

arrN — N массивов, из которых создаётся новый массив. Array(T).

Возвращаемое значение Возвращает массив различных элементов, которые присутствуют не во всех исходных массивах Array(T) Примеры Пример использования

Query

SELECT
arraySymmetricDifference([1, 2], [1, 2], [1, 2]) AS empty_symmetric_difference,
arraySymmetricDifference([1, 2], [1, 2], [1, 3]) AS non_empty_symmetric_difference;

Response

┌─empty_symmetric_difference─┬─non_empty_symmetric_difference─┐
│ []                         │ [3,2]                          │
└────────────────────────────┴────────────────────────────────┘

arrayTranspose

Добавленный в: v26.4.0 Транспонирует двумерный массив. Все вложенные массивы должны иметь одинаковую длину. Синтаксис

arrayTranspose(arr)

Аргументы

arr — двумерный массив для транспонирования. Все внутренние массивы должны иметь одинаковую длину. Array(Array(T))

Возвращаемое значение Транспонированный двумерный массив, в котором элемент [i][j] результата равен элементу [j][i] исходного массива. Array(Array(T)) Примеры Квадратная матрица

Query

SELECT arrayTranspose([[1, 2], [3, 4]])

Response

[[1, 3], [2, 4]]

Неквадратная матрица

Query

SELECT arrayTranspose([[1, 2, 3], [4, 5, 6]])

Response

[[1, 4], [2, 5], [3, 6]]

Строковые элементы

Query

SELECT arrayTranspose([['a', 'b'], ['c', 'd']])

Response

[['a', 'c'], ['b', 'd']]

arrayUnion

Добавленный в: v24.10.0 Принимает несколько массивов и возвращает массив, содержащий все элементы, которые присутствуют хотя бы в одном из исходных массивов. Результат содержит только уникальные значения. Синтаксис

arrayUnion(arr1, arr2, ..., arrN)

Аргументы

arrN — N массивов, из которых создаётся новый массив. Array(T)

Возвращаемое значение Возвращает массив с уникальными элементами из исходных массивов Array(T) Примеры Пример использования

Query

SELECT
arrayUnion([-2, 1], [10, 1], [-2], []) as num_example,
arrayUnion(['hi'], [], ['hello', 'hi']) as str_example,
arrayUnion([1, 3, NULL], [2, 3, NULL]) as null_example

Response

┌─num_example─┬─str_example────┬─null_example─┐
│ [10,-2,1]   │ ['hello','hi'] │ [3,2,1,NULL] │
└─────────────┴────────────────┴──────────────┘

arrayUniq

Добавленный в: v1.1.0 При передаче одного аргумента подсчитывает количество различных элементов в массиве. При передаче нескольких аргументов подсчитывает количество различных кортежей, составленных из элементов, находящихся на соответствующих позициях в нескольких массивах. Например, SELECT arrayUniq([1,2], [3,4], [5,6]) сформирует следующие кортежи:

Позиция 1: (1,3,5)
Позиция 2: (2,4,6)

Затем будет подсчитано количество уникальных кортежей. В данном случае это 2. Все переданные массивы должны иметь одинаковую длину.

Если вы хотите получить список уникальных элементов массива, можно использовать arrayReduce('groupUniqArray', arr).

Синтаксис

arrayUniq(arr1[, arr2, ..., arrN])

Аргументы

arr1 — Массив, для которого подсчитывается количество уникальных элементов. Array(T)
[, arr2, ..., arrN] — Необязательно. Дополнительные массивы, используемые для подсчета количества уникальных кортежей из элементов, находящихся на соответствующих позициях в нескольких массивах. Array(T)

Возвращаемое значение Для одного аргумента возвращает количество уникальных элементов. Для нескольких аргументов возвращает количество уникальных кортежей, составленных из элементов, находящихся на соответствующих позициях в массивах. UInt32 Примеры Один аргумент

Query

SELECT arrayUniq([1, 1, 2, 2])

Response

Несколько аргументов

Query

SELECT arrayUniq([1, 2, 3, 1], [4, 5, 6, 4])

Response

arrayWithConstant

Добавленный в: v20.1.0 Создаёт массив длиной length, заполненный постоянным значением x. Синтаксис

arrayWithConstant(N, x)

Аргументы

length — Количество элементов в массиве. (U)Int*
x — Значение для N элементов массива, любого типа.

Возвращаемое значение Возвращает массив Array из N элементов со значением x. Array(T) Примеры Пример использования

Query

SELECT arrayWithConstant(3, 1)

Response

[1, 1, 1]

arrayZip

Добавленный в: v20.1.0 Объединяет несколько массивов в один. Результирующий массив содержит соответствующие элементы исходных массивов, сгруппированные в кортежи в порядке перечисленных аргументов. Синтаксис

arrayZip(arr1, arr2, ... , arrN)

Аргументы

arr1, arr2, ... , arrN — N массивов, объединяемых в один массив. Array(T)

Возвращаемое значение Возвращает массив с элементами из исходных массивов, сгруппированными в кортежи. Типы данных в кортеже совпадают с типами входных массивов и идут в том же порядке, в котором передаются массивы Array(T) Примеры Пример использования

Query

SELECT arrayZip(['a', 'b', 'c'], [5, 2, 1]);

Response

[('a', 5), ('b', 2), ('c', 1)]

arrayZipUnaligned

Добавленный в: v20.1.0 Объединяет несколько массивов в один, допуская несовпадение их длины. Результирующий массив содержит соответствующие элементы исходных массивов, сгруппированные в кортежи в указанном порядке аргументов. Синтаксис

arrayZipUnaligned(arr1, arr2, ..., arrN)

Аргументы

arr1, arr2, ..., arrN — N массивов, объединённых в один массив. Array(T)

Возвращаемое значение Возвращает массив с элементами из исходных массивов, объединёнными в кортежи. Типы данных в кортеже совпадают с типами входных массивов и идут в том же порядке, в котором передаются массивы. Array(T) или Tuple(T1, T2, ...) Примеры Пример использования

Query

SELECT arrayZipUnaligned(['a'], [1, 2, 3]);

Response

[('a', 1),(NULL, 2),(NULL, 3)]

countEqual

Добавлено в: v1.1.0 Возвращает количество элементов массива, равных x. Эквивалентно arrayCount(elem -> elem = x, arr). Элементы NULL рассматриваются как отдельные значения. Синтаксис

countEqual(arr, x)

Аргументы

arr — Массив, в котором выполняется поиск. Array(T)
x — Значение в массиве, количество вхождений которого нужно подсчитать. Любой тип.

Возвращаемое значение Возвращает количество элементов массива, равных x UInt64 Примеры Пример использования

Query

SELECT countEqual([1, 2, NULL, NULL], NULL)

Response

empty

Добавленный в: v1.1.0 Проверяет, пуст ли входной массив. Массив считается пустым, если не содержит ни одного элемента.

Можно оптимизировать, включив настройку optimize_functions_to_subcolumns. При optimize_functions_to_subcolumns = 1 функция читает только подстолбец size0 вместо чтения и обработки всего столбца типа Array. Запрос SELECT empty(arr) FROM TABLE; преобразуется в SELECT arr.size0 = 0 FROM TABLE;.

Функция также работает со строками и UUID. Синтаксис

empty(arr)

Аргументы

arr — Входной массив. Array(T)

Возвращаемое значение Возвращает 1 для пустого массива и 0 — для непустого массива UInt8 Примеры Пример использования

Query

SELECT empty([]);

Response

emptyArrayDate

Добавленный в: v1.1.0 Возвращает пустой массив типа Date Синтаксис

emptyArrayDate()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив Date. Array(T) Примеры Пример использования

Query

SELECT emptyArrayDate

Response

[]

emptyArrayDateTime

Добавленный в: v1.1.0 Возвращает пустой массив DateTime Синтаксис

emptyArrayDateTime()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив DateTime. Array(T) Примеры Пример использования

Query

SELECT emptyArrayDateTime

Response

[]

emptyArrayFloat32

Добавленный в: v1.1.0 Возвращает пустой массив типа Float32 Синтаксис

emptyArrayFloat32()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив типа Float32. Array(T) Примеры Пример использования

Query

SELECT emptyArrayFloat32

Response

[]

emptyArrayFloat64

Добавленный в: v1.1.0 Возвращает пустой массив типа Float64 Синтаксис

emptyArrayFloat64()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив Float64. Array(T) Примеры Пример использования

Query

SELECT emptyArrayFloat64

Response

[]

emptyArrayInt16

Добавленный в: v1.1.0 Возвращает пустой массив Int16 Синтаксис

emptyArrayInt16()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив Int16. Array(T) Примеры Пример использования

Query

SELECT emptyArrayInt16

Response

[]

emptyArrayInt32

Добавленный в: v1.1.0 Возвращает пустой массив типа Int32 Синтаксис

emptyArrayInt32()

Аргументы

Нет аргументов.

Возвращаемое значение Пустой массив Int32. Array(T) Примеры Пример использования

Query

SELECT emptyArrayInt32

Response

[]

emptyArrayInt64

Добавленный в: v1.1.0 Возвращает пустой массив Int64 Синтаксис

emptyArrayInt64()

Аргументы

Нет.

Возвращаемое значение Пустой массив Int64. Array(T) Примеры Пример использования

Query

SELECT emptyArrayInt64

Response

[]

emptyArrayInt8

Добавленный в: v1.1.0 Возвращает пустой массив типа Int8 Синтаксис

emptyArrayInt8()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив Int8. Array(T) Примеры Пример использования

Query

SELECT emptyArrayInt8

Response

[]

emptyArrayString

Добавленный в: v1.1.0 Возвращает пустой массив типа String Синтаксис

emptyArrayString()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив строк. Array(T) Примеры Пример использования

Query

SELECT emptyArrayString

Response

[]

emptyArrayToSingle

Добавленный в: v1.1.0 Принимает пустой массив и возвращает одноэлементный массив со значением по умолчанию. Синтаксис

emptyArrayToSingle(arr)

Аргументы

arr — Пустой массив. Array(T)

Возвращаемое значение Массив с одним значением типа, используемого по умолчанию для массива. Array(T) Примеры Базовый пример

Query

CREATE TABLE test (
  a Array(Int32),
  b Array(String),
  c Array(DateTime)
)
ENGINE = MergeTree
ORDER BY tuple();

INSERT INTO test VALUES ([], [], []);

SELECT emptyArrayToSingle(a), emptyArrayToSingle(b), emptyArrayToSingle(c) FROM test;

Response

┌─emptyArrayToSingle(a)─┬─emptyArrayToSingle(b)─┬─emptyArrayToSingle(c)───┐
│ [0]                   │ ['']                  │ ['1970-01-01 01:00:00'] │
└───────────────────────┴───────────────────────┴─────────────────────────┘

emptyArrayUInt16

Добавлено в: v1.1.0 Возвращает пустой массив UInt16 Синтаксис

emptyArrayUInt16()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив типа UInt16. Array(T) Примеры Пример использования

Query

SELECT emptyArrayUInt16

Response

[]

emptyArrayUInt32

Добавленный в: v1.1.0 Возвращает пустой массив типа UInt32 Синтаксис

emptyArrayUInt32()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив типа UInt32. Array(T) Примеры Пример использования

Query

SELECT emptyArrayUInt32

Response

[]

emptyArrayUInt64

Добавленный в: v1.1.0 Возвращает пустой массив типа UInt64 Синтаксис

emptyArrayUInt64()

Аргументы

Нет.

Возвращаемое значение Пустой массив UInt64. Array(T) Примеры Пример использования

Query

SELECT emptyArrayUInt64

Response

[]

emptyArrayUInt8

Добавлено в: v1.1.0 Возвращает пустой массив UInt8 Синтаксис

emptyArrayUInt8()

Аргументы

Отсутствуют.

Возвращаемое значение Пустой массив UInt8. Array(T) Примеры Пример использования

Query

SELECT emptyArrayUInt8

Response

[]

has

Добавленный в: v1.1.0 Возвращает, содержит ли массив указанный элемент, Map — указанный ключ, а объект JSON — указанный путь. Для JSON поддерживаются вложенные пути с точечной нотацией (например, ‘a.b.c’). Когда первый аргумент — константный массив, а второй — столбец или выражение, has(constant_array, column) работает как column IN (constant_array) и для оптимизации может использовать первичный ключ и индексы пропуска данных. Например, has([1, 10, 100], id) может использовать индекс первичного ключа, если id входит в PRIMARY KEY. Эта оптимизация также применяется, когда столбец обёрнут в монотонную функцию (например, has([...], toDate(ts))). Синтаксис

has(haystack, needle)

Аргументы

haystack — Исходный массив, map или JSON. Array или Map или JSON
needle — Искомое значение (элемент массива, ключ в map или строка path в JSON).

Возвращаемое значение Возвращает 1, если haystack содержит указанное значение needle, в противном случае — 0. UInt8 Примеры Базовое использование Array

Query

SELECT has([1, 2, 3], 2)

Response

Массив не найден

Query

SELECT has([1, 2, 3], 4)

Response

Базовое использование Map

Query

SELECT has(map('a', 1, 'b', 2), 'b')

Response

JSON-путь

Query

SELECT has('{"a": {"b": 1}}'::JSON, 'a.b')

Response

hasAll

Добавленный в: v1.1.0 Проверяет, является ли один массив подмножеством другого массива.

Пустой массив является подмножеством любого массива.
Null обрабатывается как значение.
Порядок значений в обоих массивах не имеет значения.

Синтаксис

hasAll(set, subset)

Аргументы

set — массив любого типа с набором элементов. Array(T)
subset — массив любого типа, элементы которого имеют с set общий супертип; используется для проверки того, что он является подмножеством set. Array(T)

Возвращаемое значение

1, если set содержит все элементы из subset.
0 — в противном случае.

Вызывает исключение NO_COMMON_TYPE, если элементы set и subset не имеют общего супертипа. Примеры Пустые массивы

Query

SELECT hasAll([], [])

Response

Массивы со значениями NULL

Query

SELECT hasAll([1, Null], [Null])

Response

Массивы со значениями другого типа

Query

SELECT hasAll([1.0, 2, 3, 4], [1, 3])

Response

Массивы со значениями String

Query

SELECT hasAll(['a', 'b'], ['a'])

Response

Массивы без общего типа

Query

SELECT hasAll([1], ['a'])

Response

Raises a NO_COMMON_TYPE exception

Массив массивов

Query

SELECT hasAll([[1, 2], [3, 4]], [[1, 2], [3, 5]])

Response

hasAny

Добавленный в: v1.1.0 Проверяет, есть ли у двух массивов общие элементы.

Null обрабатывается как значение.
Порядок значений в обоих массивах не имеет значения.

Синтаксис

hasAny(arr_x, arr_y)

Аргументы

arr_x — Массив любого типа с элементами. Array(T)
arr_y — Массив любого типа, имеющий общий супертип с массивом arr_x. Array(T)

Возвращаемое значение

1, если arr_x и arr_y имеют хотя бы один общий элемент.
0 — в противном случае.

Вызывает исключение NO_COMMON_TYPE, если какие-либо элементы двух массивов не имеют общего супертипа. Примеры Один из массивов пуст

Query

SELECT hasAny([1], [])

Response

Массивы со значениями NULL

Query

SELECT hasAny([Null], [Null, 1])

Response

Массивы со значениями другого типа

Query

SELECT hasAny([-128, 1., 512], [1])

Response

Массивы без общего типа

Query

SELECT hasAny([[1, 2], [3, 4]], ['a', 'c'])

Response

Вызывает исключение `NO_COMMON_TYPE`

Массив массивов

Query

SELECT hasAll([[1, 2], [3, 4]], [[1, 2], [1, 2]])

Response

hasSubstr

Добавленный в: v20.6.0 Проверяет, встречаются ли все элементы array2 в array1 в точно таком же порядке. Следовательно, функция вернёт 1 тогда и только тогда, когда array1 = prefix + array2 + suffix. Иными словами, функция проверяет, содержатся ли все элементы array2 в array1, как и функция hasAll. Кроме того, она проверяет, что элементы следуют в одинаковом порядке и в array1, и в array2.

Функция вернёт 1, если array2 пуст.
NULL обрабатывается как значение. Иными словами, hasSubstr([1, 2, NULL, 3, 4], [2,3]) вернёт 0. Однако hasSubstr([1, 2, NULL, 3, 4], [2,NULL,3]) вернёт 1
Порядок значений в обоих массивах важен.

Вызывает исключение NO_COMMON_TYPE, если какие-либо элементы двух массивов не имеют общего супертипа. Синтаксис

hasSubstr(arr1, arr2)

Аргументы

arr1 — Массив любого типа с произвольным набором элементов. Array(T)
arr2 — Массив любого типа с произвольным набором элементов. Array(T)

Возвращаемое значение Возвращает 1, если массив arr1 содержит массив arr2; в противном случае возвращает 0. UInt8 Примеры Оба массива пусты

Query

SELECT hasSubstr([], [])

Response

Массивы со значениями NULL

Query

SELECT hasSubstr([1, Null], [Null])

Response

Массивы, содержащие значения другого типа

Query

SELECT hasSubstr([1.0, 2, 3, 4], [1, 3])

Response

Массивы со строками

Query

SELECT hasSubstr(['a', 'b'], ['a'])

Response

Массивы с корректным порядком

Query

SELECT hasSubstr(['a', 'b' , 'c'], ['a', 'b'])

Response

Массивы с некорректным порядком

Query

SELECT hasSubstr(['a', 'b' , 'c'], ['a', 'c'])

Response

Массив массивов

Query

SELECT hasSubstr([[1, 2], [3, 4], [5, 6]], [[1, 2], [3, 4]])

Response

Массивы без общего типа

Query

SELECT hasSubstr([1, 2, NULL, 3, 4], ['a'])

Response

Вызывает исключение `NO_COMMON_TYPE`

indexOf

Добавленный в: v1.1.0 Возвращает индекс первого элемента со значением ‘x’ (начиная с 1), если такой элемент есть в массиве. Если массив не содержит искомого значения, функция возвращает 0. Элементы со значением NULL обрабатываются как обычные значения. Синтаксис

indexOf(arr, x)

Аргументы

arr — Массив, в котором выполняется поиск x. Array(T)
x — Значение первого совпавшего элемента в arr, индекс которого нужно вернуть. UInt64

Возвращаемое значение Возвращает индекс (начиная с единицы) первого x в arr, если он существует. В противном случае возвращает 0. UInt64 Примеры Базовый пример

Query

SELECT indexOf([5, 4, 1, 3], 3)

Response

Массив с NULL

Query

SELECT indexOf([1, 3, NULL, NULL], NULL)

Response

indexOfAssumeSorted

Добавленный в: v24.12.0 Возвращает индекс первого элемента со значением ‘x’ (начиная с 1), если он присутствует в массиве. Если массив не содержит искомого значения, функция возвращает 0.

В отличие от функции indexOf, эта функция предполагает, что массив отсортирован по возрастанию. Если массив не отсортирован, результат не определён.

Синтаксис

indexOfAssumeSorted(arr, x)

Аргументы

arr — Отсортированный массив, в котором выполняется поиск. Array(T)
x — Значение первого совпадающего элемента в отсортированном arr, индекс которого нужно вернуть. UInt64

Возвращаемое значение Возвращает индекс (начиная с единицы) первого x в arr, если такой элемент существует. В противном случае возвращает 0. UInt64 Примеры Базовый пример

Query

SELECT indexOfAssumeSorted([1, 3, 3, 3, 4, 4, 5], 4)

Response

kql_array_sort_asc

Добавленный в: v23.10.0 Сортирует один или несколько массивов по возрастанию. Первый массив сортируется, а последующие массивы переупорядочиваются в соответствии с отсортированным порядком первого массива. Значения NULL помещаются в конец. Это функция совместимости с KQL (Kusto Query Language). Синтаксис

kql_array_sort_asc(array1[, array2, ..., nulls_last])

Аргументы

array1 — Массив, который нужно отсортировать. Array(T)
array2 — Необязательно. Дополнительные массивы, которые переупорядочиваются в соответствии с порядком сортировки array1. Array(T)
nulls_last — Необязательно. Логическое значение, указывающее, должны ли значения NULL располагаться в конце. По умолчанию — true. UInt8

Возвращаемое значение Возвращает кортеж массивов, отсортированных по возрастанию. Tuple(Array, ...) Примеры Базовое использование

Query

SELECT kql_array_sort_asc([3, 1, 2])

Response

([1, 2, 3])

kql_array_sort_desc

Добавленный в: v23.10.0 Сортирует один или несколько массивов по убыванию. Первый массив сортируется, а последующие переупорядочиваются в соответствии с отсортированным порядком первого массива. Значения NULL помещаются в конец. Это функция совместимости с KQL (Kusto Query Language). Синтаксис

kql_array_sort_desc(array1[, array2, ..., nulls_last])

Аргументы

array1 — Массив, который нужно отсортировать. Array(T)
array2 — Необязательные дополнительные массивы, которые переупорядочиваются в соответствии с порядком сортировки array1. Array(T)
nulls_last — Необязательное логическое значение, указывающее, должны ли значения NULL располагаться в конце. По умолчанию — true. UInt8

Возвращаемое значение Возвращает кортеж массивов, отсортированных по убыванию. Tuple(Array, ...) Примеры Базовое использование

Query

SELECT kql_array_sort_desc([3, 1, 2])

Response

([3, 2, 1])

length

Добавленный в: v1.1.0 Вычисляет длину строки или массива.

Для аргументов String или FixedString: вычисляет число байтов в строке.
Для аргументов Array: вычисляет число элементов в массиве.
Если функция применяется к аргументу FixedString, она является константным выражением.

Обратите внимание, что число байтов в строке — это не то же самое, что число Unicode “кодовых точек”, и не то же самое, что число Unicode “графемных кластеров” (то, что мы обычно называем “символами”), и не то же самое, что отображаемая ширина строки. В строках могут присутствовать ASCII-байты NULL, и они тоже учитываются. Синтаксис

length(x)

Псевдонимы: OCTET_LENGTH Аргументы

x — значение, для которого вычисляется число байтов (для String/FixedString) или элементов (для Array). String или FixedString или Array(T)

Возвращаемое значение Возвращает число байтов в String/FixedString x или число элементов в массиве x UInt64 Примеры Пример для String

Query

SELECT length('Hello, world!')

Response

Пример Array

Query

SELECT length(['Hello', 'world'])

Response

пример с constexpr

Query

WITH 'hello' || toString(number) AS str
SELECT str,
isConstant(length(str)) AS str_length_is_constant,
isConstant(length(str::FixedString(6))) AS fixed_str_length_is_constant
FROM numbers(3)

Response

┌─str────┬─str_length_is_constant─┬─fixed_str_length_is_constant─┐
│ hello0 │                      0 │                            1 │
│ hello1 │                      0 │                            1 │
│ hello2 │                      0 │                            1 │
└────────┴────────────────────────┴──────────────────────────────┘

пример Unicode

Query

SELECT 'ёлка' AS str1, length(str1), lengthUTF8(str1), normalizeUTF8NFKD(str1) AS str2, length(str2), lengthUTF8(str2)

Response

┌─str1─┬─length(str1)─┬─lengthUTF8(str1)─┬─str2─┬─length(str2)─┬─lengthUTF8(str2)─┐
│ ёлка │            8 │                4 │ ёлка │           10 │                5 │
└──────┴──────────────┴──────────────────┴──────┴──────────────┴──────────────────┘

Пример ascii_vs_utf8

Query

SELECT 'ábc' AS str, length(str), lengthUTF8(str)

Response

┌─str─┬─length(str)──┬─lengthUTF8(str)─┐
│ ábc │            4 │               3 │
└─────┴──────────────┴─────────────────┘

notEmpty

Добавленный в: v1.1.0 Проверяет, является ли входной массив непустым. Массив считается непустым, если содержит хотя бы один элемент.

Можно оптимизировать, включив настройку optimize_functions_to_subcolumns. При optimize_functions_to_subcolumns = 1 функция читает только подстолбец size0 вместо чтения и обработки всего столбца типа Array. Запрос SELECT notEmpty(arr) FROM table преобразуется в SELECT arr.size0 != 0 FROM TABLE.

Функция также работает для строк и UUID. Синтаксис

notEmpty(arr)

Аргументы

arr — входной массив. Array(T)

Возвращаемое значение Возвращает 1 для непустого массива и 0 — для пустого массива UInt8 Примеры Пример использования

Query

SELECT notEmpty([1,2]);

Response

range

Добавленный в: v1.1.0 Возвращает массив чисел от start до end - 1 с шагом step. Поддерживаются следующие типы:

UInt8/16/32/64
Int8/16/32/64]
Все аргументы start, end, step должны относиться к одному из поддерживаемых выше типов. Элементы возвращаемого массива будут супертипом аргументов.
Генерируется исключение, если функция возвращает массив, общая длина которого превышает количество элементов, заданное настройкой function_range_max_elements_in_block.
Возвращает NULL, если любой аргумент имеет тип Nullable(nothing). Генерируется исключение, если любой аргумент имеет значение NULL (тип Nullable(T)).

Синтаксис

range([start, ] end [, step])

Аргументы

start — Необязательный. Первый элемент массива. Обязателен, если используется step. Значение по умолчанию: 0. - end — Обязательный. Число, до которого строится массив. - step — Необязательный. Определяет шаг между элементами массива. Значение по умолчанию: 1.

Возвращаемое значение Массив чисел от start до end - 1 с шагом step. Array(T) Примеры Пример использования

Query

SELECT range(5), range(1, 5), range(1, 5, 2), range(-1, 5, 2);

Response

┌─range(5)────┬─range(1, 5)─┬─range(1, 5, 2)─┬─range(-1, 5, 2)─┐
│ [0,1,2,3,4] │ [1,2,3,4]   │ [1,3]          │ [-1,1,3]        │
└─────────────┴─────────────┴────────────────┴─────────────────┘

replicate

Добавленный в: v1.1.0 Создает массив, содержащий одно значение. Синтаксис

replicate(x, arr)

Аргументы

x — Значение, которым заполняется результирующий массив. Any
arr — Массив. Array(T)

Возвращаемое значение Возвращает массив той же длины, что и arr, заполненный значением x. Array(T) Примеры Пример использования

Query

SELECT replicate(1, ['a', 'b', 'c']);

Response

┌─replicate(1, ['a', 'b', 'c'])───┐
│ [1, 1, 1]                       │
└─────────────────────────────────┘

reverse

Добавленный в: v1.1.0 Изменяет порядок элементов входного массива или символов входной строки на обратный. Синтаксис

reverse(arr | str)

Аргументы

arr | str — Исходный массив или строка. Array(T) или String

Возвращаемое значение Возвращает массив или строку, в которых порядок элементов или символов обратный. Примеры Обратный порядок элементов массива

Query

SELECT reverse([1, 2, 3, 4]);

Response

[4, 3, 2, 1]

Реверс строки

Query

SELECT reverse('abcd');

Response

'dcba'

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

Все поддерживаемые функции описаны в документации по функциям расстояния.

Последнее изменение 10 июня 2026 г.

arrayJoinДокументация по функции arrayJoin

​array

​arrayAUCPR

​arrayAll

​arrayAutocorrelation

​arrayAvg

​arrayCompact

​arrayConcat

​arrayCount

​arrayCumSum

​arrayCumSumNonNegative

​arrayDifference

​arrayDistinct

​arrayDotProduct

​arrayElement

​arrayElementOrNull

​arrayEnumerate

​arrayEnumerateDense

​arrayEnumerateDenseRanked

​arrayEnumerateUniq

​arrayEnumerateUniqRanked

​arrayExcept

​arrayExists

​arrayFill

​arrayFilter

​arrayFirst

​arrayFirstIndex

​arrayFirstOrNull

​arrayFlatten

​arrayFold

​arrayIntersect

​arrayJaccardIndex

​arrayJoin

​arrayLast

​arrayLastIndex

​arrayLastOrNull

​arrayLevenshteinDistance

​arrayLevenshteinDistanceWeighted

​arrayMap

​arrayMax

​arrayMin

​arrayNormalizedGini

​arrayPartialReverseSort

​arrayPartialShuffle

​arrayPartialSort

​arrayPopBack

​arrayPopFront

​arrayProduct

​arrayPushBack

​arrayPushFront

​arrayROCAUC

​arrayRandomSample

​arrayReduce

​arrayReduceInRanges

​arrayRemove

​arrayResize

​arrayReverse

​arrayReverseFill

​arrayReverseSort

​arrayReverseSplit

​arrayRotateLeft

​arrayRotateRight

​arrayShiftLeft

​arrayShiftRight

​arrayShingles

​arrayShuffle

​arraySimilarity

​arraySlice

​arraySort

​arraySplit

​arraySum

​arraySymmetricDifference

​arrayTranspose

​arrayUnion

​arrayUniq

​arrayWithConstant

​arrayZip

​arrayZipUnaligned

​countEqual

​empty

​emptyArrayDate

array

arrayAUCPR

arrayAll

arrayAutocorrelation

arrayAvg

arrayCompact

arrayConcat

arrayCount

arrayCumSum

arrayCumSumNonNegative

arrayDifference

arrayDistinct

arrayDotProduct

arrayElement

arrayElementOrNull

arrayEnumerate

arrayEnumerateDense

arrayEnumerateDenseRanked

arrayEnumerateUniq

arrayEnumerateUniqRanked

arrayExcept

arrayExists

arrayFill

arrayFilter

arrayFirst

arrayFirstIndex

arrayFirstOrNull

arrayFlatten

arrayFold

arrayIntersect

arrayJaccardIndex

arrayJoin

arrayLast

arrayLastIndex

arrayLastOrNull

arrayLevenshteinDistance

arrayLevenshteinDistanceWeighted

arrayMap

arrayMax

arrayMin

arrayNormalizedGini

arrayPartialReverseSort

arrayPartialShuffle

arrayPartialSort

arrayPopBack

arrayPopFront

arrayProduct

arrayPushBack

arrayPushFront

arrayROCAUC

arrayRandomSample

arrayReduce

arrayReduceInRanges

arrayRemove

arrayResize

arrayReverse

arrayReverseFill

arrayReverseSort

arrayReverseSplit

arrayRotateLeft

arrayRotateRight

arrayShiftLeft

arrayShiftRight

arrayShingles

arrayShuffle

arraySimilarity

arraySlice

arraySort

arraySplit

arraySum

arraySymmetricDifference

arrayTranspose

arrayUnion

arrayUniq

arrayWithConstant

arrayZip

arrayZipUnaligned

countEqual

empty

emptyArrayDate