CREATE FUNCTION FROM 语句

该语句是 SQL ANSI/ISO 标准的扩展。请在 ESQL/C 中使用此语句。

语法

元素	描述	限制	语法
file	包含完整 CREATE FUNCTION 语句文本的文件的路径和文件名。缺省路径名为当前目录。	必须存在，且仅包含一个 CREATE FUNCTION 语句	必须遵循操作系统规则
file_var	存储 file 值的变量	与 file 的限制相同	特定于语言

用法

使用 C 或 Java™ 语句编写的函数称为外部函数。当 IFX_EXTEND_ROLE 配置参数设置成 ON 时，只有被授予内置 EXTEND 角色的用户才可以创建外部函数。

GBase 8s ESQL/C 程序不能直接创建用户定义的函数。即，它不能包含 CREATE FUNCTION 语句。

在 GBase 8s ESQL/C 程序内创建这些函数：

用 CREATE FUNCTION 语句创建源文件。
使用 CREATE FUNCTION FROM 语句将该源文件的内容发送到数据库服务器以执行。
您在 file 参数中指定的文件只能包含一个 CREATE FUNCTION 语句。

例如：假设以下 CREATE FUNCTION 语句位于名为 del_ord.sql 的独立文件中：

CREATE FUNCTION delete_order( p_order_num INT) RETURNING INT, INT;
                  DEFINE item_count INT;
                  SELECT count(*) INTO item_count FROM items
                  WHERE order_num = p_order_num;
                  DELETE FROM orders WHERE order_num = p_order_num;
                  RETURN p_order_num, item_count;
                  END FUNCTION;

在 GBase 8s ESQL/C 程序中，您可以使用以下 CREATE FUNCTION FROM 语句访问 delete_order( ) SPL 函数：

EXEC SQL create function from 'del_ord.sql';

如果您不确定文件中的 UDR 是用户定义的函数还是用户定义的过程，请使用 CREATE ROUTINE FROM 语句。

您提供的文件名是相对的。如果您提供不带路径名的简单文件名（如上述示例所示），则客户端应用程序在当前目录中查找该文件。

Important： GBase 8s ESQL/C 预处理器不处理您指定的文件的内容。它只将内容发送到数据库服务器以执行。因此，对于您在 CREATE FUNCTION FROM 中指定的文件是否实际包含 CREATE FUNCTION 语句没有进行语法检查。然而，要提高代码的可读性，建议匹配这两个语句。