Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

CREATE FUNCTION

从 Lambda 表达式创建用户自定义函数 (UDF)。该表达式必须由函数参数、常量、运算符或其他函数调用构成。

语法

CREATE [OR REPLACE] FUNCTION name [ON CLUSTER cluster] AS (parameter0, ...) -> expression

一个函数可以有任意数量的参数。

但有以下几项限制:

  • 函数名称在用户自定义函数和系统函数中必须唯一。
  • 不允许使用递归函数。
  • 函数使用的所有变量都必须在其参数列表中声明。

如果违反其中任何一项限制,就会引发异常。

示例

Querysql
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
SELECT number, linear_equation(number, 2, 1) FROM numbers(3);
Responsetext
┌─number─┬─plus(multiply(2, number), 1)─┐
│      0 │                            1 │
│      1 │                            3 │
│      2 │                            5 │
└────────┴──────────────────────────────┘

在下面的查询中,用户自定义函数调用了一个条件函数

Querysql
CREATE FUNCTION parity_str AS (n) -> if(n % 2, 'odd', 'even');
SELECT number, parity_str(number) FROM numbers(3);
Responsetext
┌─number─┬─if(modulo(number, 2), 'odd', 'even')─┐
│      0 │ even                                 │
│      1 │ odd                                  │
│      2 │ even                                 │
└────────┴──────────────────────────────────────┘

替换现有 UDF:

Querysql
CREATE FUNCTION exampleReplaceFunction AS frame -> frame;
SELECT create_query FROM system.functions WHERE name = 'exampleReplaceFunction';
CREATE OR REPLACE FUNCTION exampleReplaceFunction AS frame -> frame + 1;
SELECT create_query FROM system.functions WHERE name = 'exampleReplaceFunction';
Responsetext
┌─create_query─────────────────────────────────────────────┐
│ CREATE FUNCTION exampleReplaceFunction AS frame -> frame │
└──────────────────────────────────────────────────────────┘

┌─create_query───────────────────────────────────────────────────┐
│ CREATE FUNCTION exampleReplaceFunction AS frame -> (frame + 1) │
└────────────────────────────────────────────────────────────────┘
Navigation