第三十六章 SQL命令 DROP QUERY
删除查询
大纲
DROP QUERY name [ FROM className ]
参数
name
- 要删除的查询的名称。名称是一个标识符。不要指定查询的参数括号。名称可以是限定的(schema.name
),也可以是非限定的(Name
)。除非指定了FROM className
子句,否则非限定查询名称将采用系统范围的默认架构名称。FROM className
- 可选-如果指定,FROM className
子句将从给定类中删除查询。如果未指定此子句, IRIS将在架构的所有类中搜索查询,并将其删除。但是,如果找不到该名称的查询,或者找到多个该名称的查询,则会返回错误代码。如果删除查询导致空类,则DROP QUERY
也会删除该类。
描述
DROP QUERY
命令删除查询。删除查询时, IRIS将从所有已授予该查询的用户和角色中吊销该查询,并将其从数据库中删除。
要删除查询,必须具有GRANT
命令指定的%DROP_QUERY
管理权限。如果要尝试删除具有已定义所有者的类的查询,则必须以类的所有者身份登录。否则,系统会生成SQLCODE-99
错误(权限冲突)。
如果包含查询定义的类定义是已部署的类,则不能删除该查询。此操作失败,并出现SQLCODE-400
错误,并显示%msg Unable to Execute DDL
以修改已部署的类:‘classname’
。
支持名称和From className
的以下组合。请注意,FROM
子句指定类包名称和查询名称,而不是SQL名称。在这些示例中,系统范围内的默认架构名称是SQLUser
,它对应于User类程序包:
DROP QUERY BonusCalc FROM queryBonusCalc
:drops the query SQLUser.BonusCalc()
.DROP QUERY BonusCalc FROM User.queryBonusCalc
:drops the query SQLUser.BonusCalc()
.DROP QUERY Test.BonusCalc FROM queryBonusCalc
:drops the query SQLUser.BonusCalc()
.DROP QUERY BonusCalc FROM Employees.queryBonusCalc
:drops the query Employees.BonusCalc()
.DROP QUERY Test.BonusCalc FROM Employees.queryBonusCalc
:drops the query Employees.BonusCalc()
.
如果指定的查询不存在,DROP QUERY
将生成SQLCODE-362
错误。如果指定的类不存在,DROP QUERY
将生成SQLCODE-360
错误。如果指定的查询可以引用两个或多个查询,DROP QUERY
将生成SQLCODE-361
错误;必须指定一个类名来解决此歧义。
也可以通过从类定义中移除查询(投影为存储过程),然后重新编译该类,或删除整个类来删除查询。
示例
下面的嵌入式SQL示例尝试从类User.Employee
中删除Myq
。
ClassMethod DropQuery()
{
&sql(DROP QUERY myq FROM User.Employee)
if SQLCODE = 0 {
w !,"查询已删除"
} elseif SQLCODE = -360 {
w !,"不存在的类: ",%msg
} elseif SQLCODE=-362 {
w !,"不存在的函数: ",%msg
} else {
w !,"意外错误代码: ",SQLCODE
}
}