ClickHouse/docs/ru/sql-reference/statements/create/function.md
2021-09-01 18:36:47 +00:00

2.3 KiB
Raw Blame History

toc_priority toc_title
38 FUNCTION

CREATE FUNCTION

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

Синтаксис

CREATE FUNCTION name AS (parameter0, ...) -> expression

У функции может быть произвольное число параметров.

Существует несколько ограничений на создаваемые функции.

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

Если какое-нибудь ограничение нарушается, то при попытке создать функцию возникает исключение.

Пример

Запрос:

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

Результат:

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

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

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

Результат:

┌─number─┬─parity(number)─┐
│      0 │ even           │
│      1 │ odd            │
│      2 │ even           │
└────────┴────────────────┘