使用 DROP FUNCTION 语句可从数据库中除去用户定义的函数。
用法
删除用户定义的函数会从数据库中除去函数的文本和可执行的版本。(请确保在数据库外保留一个函数文本副本,以防您在删除此函数后需要重建它。)
如果您不知道 UDR 是用户定义的函数还是用户定义的过程,则可以通过使用 DROP ROUTINE语句删除 UDR 。
要使用 DROP FUNCTION 语句,您必须是此用户定义函数的所有者(并持有数据库上的 Resource权限)或者具有 DBA 权限。您还必须持有编写该 UDR 的程序语言的 Usage 权限。要删除外部
用户定义的函数,另见 删除外部例程。
您不能使用 DROP ROUTINE 、DROP FUNCTION 或 DROP PROCEDURE 语句删除受保护的例程。有关受保护例程的更多信息,请参阅 《GBase 8s SQL 指南:参考》 系统目录表sysprocedures 的描述。
您无法从相同的 SPL 函数内删除 SPL 函数。如果函数定义声明了一个指定的名称,则 GBase 8s 可通过它的 specific name 来解析函数,如果在此语句中使用指定的名称,您还必须使用关键字 SPECIFIC,如下例所示:
DROP SPECIFIC FUNCTION compare_point;
否则,如果 function 名称在数据库中不唯一,则您必须指定足够的 parameter_type 信息来明确名称 。如果使用参数数据类型标识用户定义的函数,则它们跟在函数名后面,如下例所示:
DROP FUNCTION compare (int, int);
如果数据库服务器不能解析名义模糊的函数名称(该函数名称的特征符与另一函数的特征符只在未命名的 ROW 类型参数中不同),则数据库服务器返回错误。(当定义了含义模糊的 function
后,数据库服务器不能预期此错误。)
如果您包含了可选的 IF EXISTS 关键字,则如果数据库服务器在当前数据库中没有找到与 DROPFUNCTION 语句指定的相符合的函数则数据库不采取任何操作(而不是发出错误)。
确定函数是否存在
在您尝试删除用户定义函数之前,可以通过查询系统目录来检查此函数是否在数据库中存在。以下
示例中,SELECT 语句从 sysprodures 表中检索标识为 MyFunction 的任何例程:
SELECT * FROM sysprocedures WHERE procname = MyFunction;
如果此查询返回一行,则名为 MyFunction 的 UDR 注册在当前数据库中。
如果此查询没有返回行,则您不需发出 DROP FUNCTION 语句,但是您可能希望验证 WHERE
子句指定的名称是否正确,以及您是否连接到正确的数据库。
如果此查询返回多行,则在当前数据库中重载例程 MyFunction ,并且您需要检查
MyFunction 例程的属性以确定它们中的哪些(如果有)需要通过 DROP FUNCTION 语句注销。
示例
大多数函数可以使用以下类似的 SQL 语句来删除:
DROP FUNCTION best_month;
然而,如果您有多个相同名称的函数,则通过函数重载,DROP FUNCTION 以及必须指定函数的
特定名称(如果有)或参数列表来唯一标识它。例如,superstores_demo 数据库有两个使用以下
参数创建的 last_contact 函数:
CREATE FUNCTION last_contact(cust_name name_t) ... 和 CREATE FUNCTION last_contact(c_num INT) ...
要删除第二个函数,使用以下语句:
DROP FUNCTION last_contact(INT);
如果使用指定的名称 last_cname_contact 和 last_cnum_contac 创建了上述函数,则删除其中的
第二个函数,发出以下语句:
DROP SPECIFIC FUNCTION last_cnum_contact;
现有函数的详细信息可以在 sysprocedures 系统目录表中找到,如下所示的 SQL 查询:
SELECT procname, specificname, paramtypes FROM sysprocedures ;