此语句创建一个自定义函数。执行此命令需要用户拥有 权限。
如果 function_name
中包含了数据库名字,那么这个自定义函数会创建在对应的数据库中,否则这个函数将会创建在当前会话所在的数据库。新函数的名字与参数不能够与当前命名空间中已存在的函数相同,否则会创建失败。但是只有名字相同,参数不同是能够创建成功的。
语法:
参数说明:
AGGREGATE
: 如果有此项,表示的是创建的函数是一个聚合函数。ALIAS
:如果有此项,表示的是创建的函数是一个别名函数。
如果没有上述两项,表示创建的函数是一个标量函数
function_name
: 要创建函数的名字, 可以包含数据库的名字。比如:db1.my_func
。arg_type
: 函数的参数类型,与建表时定义的类型一致。变长参数时可以使用, ...
来表示,如果是变长类型,那么变长部分参数的类型与最后一个非变长参数类型一致。ret_type
: 对创建新的函数来说,是必填项。如果是给已有函数取别名则可不用填写该参数。inter_type
: 用于表示聚合函数中间阶段的数据类型。param
:用于表示别名函数的参数,至少包含一个。:用于表示别名函数对应的原始函数。
创建一个自定义标量函数
"symbol" = "_ZN9doris_udf6AddUdfEPNS_15FunctionContextERKNS_6IntValES4_",
);
创建一个有prepare/close函数的自定义标量函数
创建一个自定义聚合函数
CREATE AGGREGATE FUNCTION my_count (BIGINT) RETURNS BIGINT PROPERTIES (
"init_fn"="_ZN9doris_udf9CountInitEPNS_15FunctionContextEPNS_9BigIntValE",
"update_fn"="_ZN9doris_udf11CountUpdateEPNS_15FunctionContextERKNS_6IntValEPNS_9BigIntValE",
"merge_fn"="_ZN9doris_udf10CountMergeEPNS_15FunctionContextERKNS_9BigIntValEPS2_",
"finalize_fn"="_ZN9doris_udf13CountFinalizeEPNS_15FunctionContextERKNS_9BigIntValE",
"object_file"="http://host:port/libudasample.so"
);
创建一个变长参数的标量函数
-
CREATE ALIAS FUNCTION id_masking(INT) WITH PARAMETER(id) AS CONCAT(LEFT(id, 3), '****', RIGHT(id, 4));