第三十五章 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 PROCEDURE也会删除该类。

描述

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
    }
}