第三十五章 SQL命令 DROP PROCEDURE
删除存储过程
大纲
DROP PROCEDURE procname [ FROM className ]
DROP PROC procname [ FROM className ]
参数
-
procname
-procname
要删除的过程的名称。名称是一个标识符。不要指定过程的参数括号。名称可以是限定的(schema.name
),也可以是非限定的(Name
)。除非指定了FROM className
子句,否则非限定过程名称将采用默认架构名称。 -
FROM className
- 可选-如果指定,FROM className
子句将从给定类中删除过程。如果未指定此子句, IRIS将在架构的所有类中搜索该过程,并将其删除。但是,如果找不到此名称的过程,或者找到多个此名称的过程,则会返回错误代码。如果删除过程导致空类,则DROP PROCEDUR
E也会删除该类。
描述
DROP PROCEDURE
命令删除当前命名空间中的过程。删除过程时, IRIS会将其从已授予该过程的所有用户和角色中撤消,并将其从数据库中删除。
要删除过程,必须具有GRANT
命令指定的%DROP_PROCEDURE
管理权限。如果要尝试删除具有已定义所有者的类的过程,则必须以类的所有者身份登录。否则,系统会生成SQLCODE-99
错误(权限冲突)。
如果包含过程定义的类定义是已部署的类,则不能删除该过程。此操作失败,并出现SQLCODE-400
错误,并显示%msg Unable to Execute DDL
以修改已部署的类:‘classname’
。
进程名不区分大小写。必须指定不带参数括号的procname
;指定参数括号会导致SQLCODE-25
错误。
支持procname
和from className
的以下组合。请注意,FROM
子句指定类包名称和过程名称,而不是SQL名称。在这些示例中,系统范围内的默认架构名称是SQLUser
,它对应于User
类程序包:
DROP PROCEDURE BonusCalc FROM procBonusCalc
:drops the procedure SQLUser.BonusCalc()
.DROP PROCEDURE BonusCalc FROM User.procBonusCalc
:drops the procedure SQLUser.BonusCalc()
.DROP PROCEDURE Test.BonusCalc FROM procBonusCalc
:drops the procedure SQLUser.BonusCalc()
.DROP PROCEDURE BonusCalc FROM Employees.procBonusCalc
:drops the procedure Employees.BonusCalc()
.DROP PROCEDURE Test.BonusCalc FROM Employees.procBonusCalc
:drops the procedure Employees.BonusCalc()
.
如果指定的过程不存在,DROP PROCEDURE
将生成SQLCODE-362
错误。如果指定的类不存在,DROP PROCEDURE
将生成SQLCODE-360
错误。如果指定的过程可以引用两个或多个过程,DROP PROCEDURE
将生成SQLCODE-361
错误;必须指定一个类名来解决此歧义。
要确定当前命名空间中是否存在指定的进程名,请使用$SYSTEM.SQL.Schema.ProcedureExists()
方法。此方法可以识别使用PROCEDURE
关键字定义的过程和方法。可以使用DROP PROCEDURE
删除使用PROCEDURE
关键字定义的方法。
如果对属于ObjectScript
类查询过程的过程执行DROP过程, IRIS还将删除与该过程相关的方法,如myprocExecute()
、myprocGetInfo()
、myprocFetch()
、myprocFetchRows()
和myprocClose()
。
还可以通过从类定义中移除存储过程,然后重新编译类,或删除整个类来删除过程。
示例
下面的嵌入式SQL示例尝试从类User.Employee
中删除myprocSP
。
ClassMethod DropProcedure()
{
&sql(DROP PROCEDURE myprocSP FROM User.Employee)
if SQLCODE = 0 {
w !,"过程已删除"
} elseif SQLCODE = -360 {
w !,"不存在的类: ",%msg
} elseif SQLCODE=-362 {
w !,"不存在的函数: ",%msg
} else {
w !,"意外错误代码: ",SQLCODE
}
}