mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-17 21:24:28 +00:00
60 lines
2.3 KiB
Markdown
60 lines
2.3 KiB
Markdown
---
|
||
toc_priority: 38
|
||
toc_title: FUNCTION
|
||
---
|
||
|
||
# CREATE FUNCTION {#create-function}
|
||
|
||
Создает пользовательскую функцию из лямбда-выражения. Выражение должно состоять из параметров функции, констант, операторов и вызовов других функций.
|
||
|
||
**Синтаксис**
|
||
|
||
```sql
|
||
CREATE FUNCTION name AS (parameter0, ...) -> expression
|
||
```
|
||
У функции может быть произвольное число параметров.
|
||
|
||
Существует несколько ограничений на создаваемые функции.
|
||
|
||
- Имя функции должно быть уникальным среди всех пользовательских и системных функций.
|
||
- Рекурсивные вызовы запрещены.
|
||
- Все переменные, используемые функцией, должны быть перечислены в списке ее параметров.
|
||
|
||
Если какое-нибудь ограничение нарушается, то при попытке создать функцию возникает исключение.
|
||
|
||
**Пример**
|
||
|
||
Запрос:
|
||
|
||
```sql
|
||
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
|
||
SELECT number, linear_equation(number, 2, 1) FROM numbers(3);
|
||
```
|
||
|
||
Результат:
|
||
|
||
``` text
|
||
┌─number─┬─linear_equation(number, 2, 1)─┐
|
||
│ 0 │ 1 │
|
||
│ 1 │ 3 │
|
||
│ 2 │ 5 │
|
||
└────────┴───────────────────────────────┘
|
||
```
|
||
|
||
В следующем запросе пользовательская функция вызывает [условную функцию](../../../sql-reference/functions/conditional-functions.md):
|
||
|
||
```sql
|
||
CREATE FUNCTION parity AS (n) -> if(n % 2, 'odd', 'even');
|
||
SELECT number, parity(number) FROM numbers(3);
|
||
```
|
||
|
||
Результат:
|
||
|
||
``` text
|
||
┌─number─┬─parity(number)─┐
|
||
│ 0 │ even │
|
||
│ 1 │ odd │
|
||
│ 2 │ even │
|
||
└────────┴────────────────┘
|
||
```
|