第三十四章 SQL命令 DROP METHOD

删除方法

大纲

DROP METHOD name [ FROM className ]

参数

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

描述

DROP METHOD命令可删除方法。删除方法时， IRIS会将其从已授予该方法的所有用户和角色中撤消，并将其从数据库中删除。

要删除方法，必须具有GRANT命令指定的%DROP_METHOD管理权限。如果要尝试删除具有已定义所有者的类的方法，则必须以类所有者的身份登录。否则，系统会生成SQLCODE-99错误(权限冲突)。

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

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

DROP METHOD BonusCalc FROM methBonusCalc: 删除该方法 SQLUser.BonusCalc().
DROP METHOD BonusCalc FROM User.methBonusCalc: 删除该方法 SQLUser.BonusCalc().
DROP METHOD Test.BonusCalc FROM methBonusCalc: 删除该方法 SQLUser.BonusCalc().
DROP METHOD BonusCalc FROM Employees.methBonusCalc: 删除该方法 Employees.BonusCalc().
DROP METHOD Test.BonusCalc FROM Employees.methBonusCalc: 删除该方法d Employees.BonusCalc().

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

如果使用PROCEDURE CHARECTURE关键字定义了方法，则可以通过调用$SYSTEM.SQL.Schema.ProcedureExists()方法来确定该方法是否存在于当前命名空间中。使用PROCEDURE关键字定义的方法可以通过DROP方法或DROP PROCEDURE删除。

还可以删除方法，方法是从类定义中移除方法，然后重新编译类，或者删除整个类。

示例

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

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