第三十二章 SQL命令 DROP FUNCTION

删除函数

大纲

DROP FUNCTION name [ FROM className ]

参数

• name - 要删除的函数的名称。名称是一个标识符。不要指定函数的参数括号。名称可以是限定的(schema.name)，也可以是非限定的(Name)。除非指定了FROM className子句，否则非限定函数名称将采用系统范围的默认架构名称。
• FROM className - 可选-如果指定，FROM className子句将从给定类中删除函数。请注意，必须指定函数的类名(FuncBonusCalc)，而不是SQL名称(BonusCalc)。如果未指定FROM子句， IRIS将在架构的所有类中搜索该函数，并将其删除。但是，如果找不到此名称的函数，或者找到多个此名称的函数，则会返回错误代码。如果删除函数会导致空类，则DROP函数也会删除该类。

描述

DROP Function命令用于删除函数。当删除某个函数时， IRIS会将其从已授予该函数的所有用户和角色中撤消，并将其从数据库中删除。

要删除函数，必须拥有由GRANT命令指定的%DROP_Function管理权限。否则，系统会生成SQLCODE-99错误(权限冲突)。

如果包含函数定义的类定义是已部署的类，则不能删除该函数。此操作失败，并出现SQLCODE-400错误，并显示%msg Unable to Execute DDL以修改已部署的类：‘classname’。

支持名称和From className的以下组合。请注意，FROM子句指定类包名称和函数名称，而不是SQL名称。在这些示例中，系统范围内的默认架构名称是SQLUser，它对应于User类程序包：

• DROP FUNCTION BonusCalc FROM funcBonusCalc: 删除函数 SQLUser.BonusCalc().
• DROP FUNCTION BonusCalc FROM User.funcBonusCalc: 删除函数 SQLUser.BonusCalc().
• DROP FUNCTION Test.BonusCalc FROM funcBonusCalc: 删除函数 SQLUser.BonusCalc().
• DROP FUNCTION BonusCalc FROM Employees.funcBonusCalc:删除函数Employees.BonusCalc().
• DROP FUNCTION Test.BonusCalc FROM Employees.funcBonusCalc: 删除函数 Employees.BonusCalc().

如果指定的函数不存在，DROP Function将生成SQLCODE-362错误。如果指定的类不存在，DROP函数将生成SQLCODE-360错误。如果指定的函数可以引用两个或多个函数，DROP Function将生成SQLCODE-361错误；必须指定一个className来解决此歧义。

示例

下面的嵌入式SQL示例尝试从类User.Employee中删除myfunc。

ClassMethod DropFunction()
{
    &sql(
        DROP FUNCTION myfunc FROM sqluser.Employee
    )
    if SQLCODE=0 {
        w !,"函数已删除" 
    } elseif SQLCODE = -360 {
        w !,"不存在的类: ",%msg 
    } elseif SQLCODE=-362 {
        w !,"不存在的函数: ",%msg 
    } else {
        w !,"意外错误代码: ",SQLCODE
    }
}