2021-09-01 18:36:47 +00:00
|
|
|
|
---
|
2022-04-09 13:29:05 +00:00
|
|
|
|
sidebar_position: 38
|
|
|
|
|
sidebar_label: FUNCTION
|
2021-09-01 18:36:47 +00:00
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# CREATE FUNCTION {#create-function}
|
|
|
|
|
|
|
|
|
|
Создает пользовательскую функцию из лямбда-выражения. Выражение должно состоять из параметров функции, констант, операторов и вызовов других функций.
|
|
|
|
|
|
|
|
|
|
**Синтаксис**
|
|
|
|
|
|
|
|
|
|
```sql
|
|
|
|
|
CREATE FUNCTION name AS (parameter0, ...) -> expression
|
|
|
|
|
```
|
|
|
|
|
У функции может быть произвольное число параметров.
|
|
|
|
|
|
2021-09-02 18:44:37 +00:00
|
|
|
|
Существует несколько ограничений на создаваемые функции:
|
2021-09-01 18:36:47 +00:00
|
|
|
|
|
|
|
|
|
- Имя функции должно быть уникальным среди всех пользовательских и системных функций.
|
2021-09-02 18:44:37 +00:00
|
|
|
|
- Рекурсивные функции запрещены.
|
2021-09-01 18:36:47 +00:00
|
|
|
|
- Все переменные, используемые функцией, должны быть перечислены в списке ее параметров.
|
|
|
|
|
|
|
|
|
|
Если какое-нибудь ограничение нарушается, то при попытке создать функцию возникает исключение.
|
|
|
|
|
|
|
|
|
|
**Пример**
|
|
|
|
|
|
|
|
|
|
Запрос:
|
|
|
|
|
|
|
|
|
|
```sql
|
|
|
|
|
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
|
|
|
|
|
SELECT number, linear_equation(number, 2, 1) FROM numbers(3);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Результат:
|
|
|
|
|
|
|
|
|
|
``` text
|
2021-09-04 16:31:04 +00:00
|
|
|
|
┌─number─┬─plus(multiply(2, number), 1)─┐
|
|
|
|
|
│ 0 │ 1 │
|
|
|
|
|
│ 1 │ 3 │
|
|
|
|
|
│ 2 │ 5 │
|
|
|
|
|
└────────┴──────────────────────────────┘
|
2021-09-01 18:36:47 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
В следующем запросе пользовательская функция вызывает [условную функцию](../../../sql-reference/functions/conditional-functions.md):
|
|
|
|
|
|
|
|
|
|
```sql
|
2021-09-04 16:31:04 +00:00
|
|
|
|
CREATE FUNCTION parity_str AS (n) -> if(n % 2, 'odd', 'even');
|
|
|
|
|
SELECT number, parity_str(number) FROM numbers(3);
|
2021-09-01 18:36:47 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Результат:
|
|
|
|
|
|
|
|
|
|
``` text
|
2021-09-04 16:31:04 +00:00
|
|
|
|
┌─number─┬─if(modulo(number, 2), 'odd', 'even')─┐
|
|
|
|
|
│ 0 │ even │
|
|
|
|
|
│ 1 │ odd │
|
|
|
|
|
│ 2 │ even │
|
|
|
|
|
└────────┴──────────────────────────────────────┘
|
2021-09-01 18:36:47 +00:00
|
|
|
|
```
|