CREATE FUNCTION（标量）
向编录添加用户定义的标量函数 (UDSF)。包含该函数的库必须先前已使用 CREATE LIBRARY 添加。
UDSF 接受单个数据行并返回单个值。只要可以使用原生 Vertica 函数或语句（CREATE TABLE 及其 PARTITION BY 或任何分段子句除外），便可以使用这些函数。
CREATE FUNCTION 根据工厂类提供的数据自动确定函数参数和返回值。Vertica 支持重载 UDx。当您调用函数时，Vertica 会将参数传递给库中的函数进行处理。
语法
CREATE [ OR REPLACE ] FUNCTION [ IF NOT EXISTS ]
[[database.]schema.]function AS
[ LANGUAGE 'language' ]
NAME 'factory'
LIBRARY library
[ FENCED | NOT FENCED ]
参数
OR REPLACE如果存在具有相同名称和实参的函数，则会替换它。例如，您可以使用它在围栏模式和非围栏模式之间进行切换。如果您不使用此指令并且该函数已存在，则 CREATE 语句将返回一个回退错误。
OR REPLACE 和 IF NOT EXISTS 是互斥的。
IF NOT EXISTS如果存在具有相同名称和实参的函数，则会返回该函数而不会创建它。
OR REPLACE 和 IF NOT EXISTS 是互斥的。
-
[database.]schema 数据库和架构。默认架构为
public。如果指定一个数据库，它必须是当前数据库。-
function 要创建的函数的名称。该名称用于函数的 SQL 调用。它不需要匹配工厂名称，但是如果这两个名称相同或相似，可以减少困惑。
函数名必须符合标识符的限制。
-
LANGUAGE 'language' - 用于开发此函数的语言，为以下语言之一：
-
C++（默认值） -
Python -
Java -
R
-
-
NAME 'factory' - 生成函数实例的工厂类的名称。
-
LIBRARY library - C++ 共享对象文件、Python 文件、Java Jar 文件或 R 函数文件的名称。此库必须已由 CREATE LIBRARY 加载。
FENCED | NOT FENCED- 启用或禁用此函数的隔离模式。以 Java 编写的函数和 R 函数始终在隔离模式下运行。
默认值：
FENCED
特权
-
函数架构的 CREATE 权限
-
函数库的 USAGE 权限
示例
以下示例加载了名为 ScalarFunctions 的库，然后定义了名为 Add2ints 的函数，该函数映射到库中的 Add2intsInfo 工厂类：
=> CREATE LIBRARY ScalarFunctions AS '/opt/vertica/sdk/examples/build/ScalarFunctions.so';
CREATE LIBRARY
=> CREATE FUNCTION Add2Ints AS LANGUAGE 'C++' NAME 'Add2IntsFactory' LIBRARY ScalarFunctions;
CREATE FUNCTION
=> \x
Expanded display is on.
=> SELECT * FROM USER_FUNCTIONS;
-[ RECORD 1 ]----------+----------------------------------------------------
schema_name | public
function_name | Add2Ints
procedure_type | User Defined Function
function_return_type | Integer
function_argument_type | Integer, Integer
function_definition | Class 'Add2IntsFactory' in Library 'public.ScalarFunctions'
volatility | volatile
is_strict | f
is_fenced | t
comment |
=> \x
Expanded display is off.
=> -- Try a simple call to the function
=> SELECT Add2Ints(23,19);
Add2Ints
----------
42
(1 row)
以下示例使用了返回 ROW 的标量函数：
=> CREATE FUNCTION div_with_rem AS LANGUAGE 'C++' NAME 'DivFactory' LIBRARY ScalarFunctions;
=> SELECT div_with_rem(18,5);
div_with_rem
------------------------------
{"quotient":3,"remainder":3}
(1 row)