DROP FUNCTION 语句

使用 DROP FUNCTION 语句可从数据库中除去用户定义的函数。该语句是 SQL ANSI/ISO 标准的扩展。

语法

元素 描述 限制 语法
function 要删除的用户定义的函数的名称 必须存在于数据库中(即已注册)。如果该名称没有唯一地标识函数,你必须输入 parameter_type 的一个或多个适当的值 标识符
parameter_type 参数的数据类型 数据类型(或数据类型列表)必须与那些在创建函数时就在 CREATE 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 关键字,则如果数据库服务器在当前数据库中没有找到与 DROP FUNCTION 语句指定的相符合的函数则数据库不采取任何操作(而不是发出错误)。

确定函数是否存在

在您尝试删除用户定义函数之前,可以通过查询系统目录来检查此函数是否在数据库中存在。以下示例中,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_contactlast_cnum_contac 创建了上述函数,则删除其中的第二个函数,发出以下语句:
DROP SPECIFIC FUNCTION last_cnum_contact;
现有函数的详细信息可以在 sysprocedures 系统目录表中找到,如下所示的 SQL 查询:
SELECT procname, specificname, paramtypes
          FROM sysprocedures ;
        
1 请参阅 专用名