sp_dropdevice (Transact-SQL)

適用対象:SQL Server

SQL Server データベース エンジン インスタンスからデータベース デバイスまたはバックアップ デバイスを削除し、からエントリmaster.dbo.sysdevicesを削除します。

Transact-SQL 構文表記規則

構文

sp_dropdevice
    [ @logicalname = ] N'logicalname'
    [ , [ @delfile = ] 'delfile' ]
[ ; ]

引数

[ @logicalname = ] N'logicalname'

に記載されているデータベース デバイスまたはバックアップ デバイスの master.dbo.sysdevices.name論理名。 @logicalnameは sysname で、既定値はありません。

[ @delfile = ] 'delfile'

物理バックアップ デバイス ファイルを削除するかどうかを指定します。 @delfileは varchar(7) で、既定値は NULL. 指定 DELFILEした場合、物理バックアップ デバイスのディスク ファイルが削除されます。

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

ありません。

解説

sp_dropdevice トランザクション内では使用できません。

アクセス許可

diskadmin 固定サーバー ロールのメンバーシップが必要です。

次の例では、テープ ダンプ デバイスをtapedump1データベース エンジンから削除します。

EXEC sp_dropdevice 'tapedump1';