文章目录


第三十六章 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
}
}