Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

DROP QUERY

クエリを削除します。

Synopsis

DROP QUERY name [ FROM className ]

引数

name 削除するクエリの名前。識別子の名前です。詳細は、"Caché SQL の使用法" の “識別子“ の章を参照してください。
FROM className オプション — 指定があれば、FROM className 節は与えられたクラスからクエリを削除します。この節が指定されていない場合、Caché はそのスキーマのすべてのクラスで該当するクエリを検索し、削除します。しかし、この名前でのクエリが見つからない場合、または同名のクエリが複数見つかった場合、エラー・コードが返されます。クエリの削除の結果、クラスが空になる場合、DROP QUERY はそのクラスも削除します。

概要

DROP QUERY コマンドはクエリを削除します。クエリを削除すると、Caché は、そのクエリ権限が与えられている全ユーザおよびロールでそれを無効にし、データベースから削除します。

クエリの削除には、GRANT コマンドで指定された %CREATE_QUERY 管理者特権が必要です。定義された所有者を持つクラスのクエリを削除しようとする場合、クラスの所有者としてログインする必要があります。この特権がないと、SQLCODE -99 エラー (特権違反) が生成されます。

指定されたクエリが存在しない場合、DROP QUERY は SQLCODE -362 エラーを発行します。指定されたクラスが存在しない場合、DROP QUERY は SQLCODE -360 エラーを発行します。指定されたクエリが複数のクエリを参照する可能性がある場合、DROP QUERY は SQLCODE -361 エラーを生成します。このあいまいさを解消するには、className を指定する必要があります。

以下の埋め込み SQL の例は、クラス User.Employee からの myq の削除を試行します (クラス User.Employee の作成例は、"CREATE TABLE" を参照してください)。

   &sql(DROP QUERY myq FROM User.Employee)
  IF SQLCODE=0 {
    WRITE !,"Query deleted" }
  ELSEIF SQLCODE=-360 {
    WRITE !,"Nonexistent class: ",%msg }
  ELSEIF SQLCODE=-362 {
    WRITE !,"Nonexistent query: ",%msg }
  ELSE {WRITE !,"Unexpected Error code: ",SQLCODE}

関連項目

FeedbackOpens in a new tab