文章目录
第三十二章 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
}
}