DROP DATABASE (SQL)

Synopsis

DROP DATABASE [IF EXISTS] dbname [RETAIN_FILES]

概要

DROP DATABASE コマンドは、1 つのネームスペース、およびそれに関連するデータベースを削除します。

指定した dbname は、ネームスペース、および対応するデータベース・ファイルを含むディレクトリの名前となります。dbname は識別子として指定します。ネームスペース名は、大文字と小文字を区別しません。指定した dbname ネームスペースが存在しない場合、InterSystems IRIS は SQLCODE -340 エラーを発行します。

DROP DATABASE コマンドは特権を必要とする操作です。DROP DATABASE を使用する前に、%Admin_Manage リソースを有するユーザとしてログインする必要があります。ユーザには、ルーチンおよびグローバルなデータベース定義のために、そのリソースの READ 許可も必要となります。特権がない場合は、SQLCODE -99 エラー (特権違反) が返されます。

$SYSTEM.Security.Login()Opens in a new tab メソッドを使用して、以下のようにユーザに適切な特権を割り当ててください。

   DO $SYSTEM.Security.Login("_SYSTEM","SYS")
   &sql(      )

$SYSTEM.Security.Login メソッドを呼び出すには、%Service_Login:Use 特権が必要です。詳細は、"インターシステムズ・クラス・リファレンス" の "%SYSTEM.SecurityOpens in a new tab" を参照してください。

DROP DATABASE は、特権に関係なく、システム・ネームスペースの削除には使用できません。これを実行しようとすると、SQLCODE -342 エラーが返されます。

DROP DATABASE は、現在使用しているか接続しているネームスペースの削除には使用できません。これを実行しようとすると、SQLCODE -344 エラーが返されます。

管理ポータルを使用してネームスペースを削除することもできます。[システム管理]、[構成]、[システム構成]、[ネームスペース] の順に選択して、既存のネームスペースをリストします。削除するネームスペースのための [削除] ボタンをクリックします。

例

以下の例では、ネームスペースとそれに関連するデータベース (この場合は、'c:\InterSystems\IRIS\mgr\DocTestDB') を削除します。物理データベース・ファイルは保持されます。

CREATE DATABASE DocTestDB ON DIRECTORY 'c:\InterSystems\IRIS142\mgr\DocTestDB'

DROP DATABASE DocTestDB RETAIN_FILES

関連項目

• CREATE DATABASE コマンド

• USE DATABASE コマンド