CREATE FUNCTION — пользовательская функция (UDF)

Создаёт пользовательскую функцию (UDF) из лямбда-выражения. Выражение должно состоять из параметров функции, констант, операторов или других вызовов функций.

Синтаксис

CREATE FUNCTION имя [ON CLUSTER кластер] AS (параметр0, ...) -> выражение

Функция может иметь произвольное количество параметров.

Существует несколько ограничений:

• Имя функции должно быть уникальным среди пользовательских и системных функций.
• Рекурсивные функции не допускаются.
• Все переменные, используемые функцией, должны быть указаны в её списке параметров.

Если какое-либо из этих ограничений нарушается, выбрасывается исключение.

Пример

Запрос:

CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
SELECT number, linear_equation(number, 2, 1) FROM numbers(3);

Результат:

┌─number─┬─plus(multiply(2, number), 1)─┐
│      0 │                            1 │
│      1 │                            3 │
│      2 │                            5 │
└────────┴──────────────────────────────┘

Условная функция вызывается в функции, определяемой пользователем, в следующем запросе:

CREATE FUNCTION parity_str AS (n) -> if(n % 2, 'odd', 'even');
SELECT number, parity_str(number) FROM numbers(3);

Результат:

┌─number─┬─if(modulo(number, 2), 'odd', 'even')─┐
│      0 │ чётное                               │
│      1 │ нечётное                             │
│      2 │ чётное                               │
└────────┴──────────────────────────────────────┘

Связанные материалы

Исполняемые UDF-функции.

Пользовательские функции в ClickHouse Cloud