sp_addumpdevice (Transact-SQL)

適用対象:yesSQL Server (サポートされているすべてのバージョン)

適用対象: SQL Server ( SQL Server 2008 から現在のバージョン)。

バックアップ デバイスをバックアップ デバイスのインスタンスに追加SQL Server。

Topic link iconTransact-SQL 構文表記規則

構文

  
sp_addumpdevice [ @devtype = ] 'device_type'   
    , [ @logicalname = ] 'logical_name'   
    , [ @physicalname = ] 'physical_name'  
      [ , { [ @cntrltype = ] controller_type |  
          [ @devstatus = ] 'device_status' }  
      ]  

引数

[ @devtype = ] 'device_type' バックアップ デバイスの種類です。 device_typevarchar(20) で、既定値はありません。次のいずれかの値を指定できます。

説明
ディスク バックアップ デバイスとしてのハード ディスク ファイル。
テープ Microsoft Windows でサポートされているテープ デバイス。

注: テープ バックアップ デバイスのサポートは、今後のバージョンの SQL Server。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。

[ @logicalname = ] 'logical_name' BACKUP ステートメントと RESTORE ステートメントで使用されるバックアップ デバイスの論理名を指定します。 logical_nameは sysname で、既定値はありません。NULL にすることはできません。

[ @physicalname = ] 'physical_name' バックアップ デバイスの物理名です。 物理名は、オペレーティング システムのファイル名またはネットワーク デバイスの汎用名前付け規則の規則に従う必要があります。また、完全なパスを含める必要があります。 physical_nameは nvarchar(260) であり、既定値はありません。NULL にすることはできません。

リモート ネットワークの場所にバックアップ デバイスを作成する場合は、データベース エンジン が開始された名前に、リモート コンピューター上で適切な書き込み機能が備え付けされている必要があります。

テープ デバイスを追加する場合、このパラメーターは Windows によってローカル テープ デバイスに割り当てられる物理名である必要があります。たとえば、コンピューター上の最初のテープ デバイスの場合は \\.\TAPE0 です。 テープ デバイスをサーバー コンピューターに接続する必要があります。リモートで使用することはできません。 英数字以外の文字を含む名前を引用符で囲みます。

Note

この手順では、指定した物理名をカタログに入力します。 この手順では、デバイスへのアクセスやデバイスの作成は試行されない。

[ @cntrltype = ] 'controller_type' 時代遅れ。 指定した場合、このパラメーターは無視されます。 旧バージョンとの互換性のためだけに用意されています。 新しいパラメーターを 使用sp_addumpdevice パラメーターを省略する必要があります。

[ @devstatus = ] 'device_status' 時代遅れ。 指定した場合、このパラメーターは無視されます。 旧バージョンとの互換性のためだけに用意されています。 新しいパラメーターを 使用sp_addumpdevice パラメーターを省略する必要があります。

リターン コードの値

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

結果セット

なし

解説

sp_addumpdevice カタログ ビューにバックアップ デバイス sys.backup_devices 追加します。 その後、そのデバイスを BACKUP ステートメントや RESTORE ステートメントで論理的に参照できるようになります。 sp_addumpdevice デバイスへのアクセスは実行されない。 BACKUP ステートメントや RESTORE ステートメントが実行されるときにだけ、指定されたデバイスにアクセスされます。 論理バックアップ デバイスを作成すると、BACKUP ステートメントと RESTORE ステートメントを簡略化できます。ここで、デバイス名の指定は、"TAPE =" 句または "DISK =" 句を使用してデバイス パスを指定する代替手段です。

所有権とアクセス許可の問題は、ディスクまたはファイル バックアップ デバイスの使用に干渉する可能性があります。 アプリケーションが開始されたアカウントに適切なWindowsアクセス許可が付与データベース エンジンしてください。

このデータベース エンジンは、デバイスでサポートされているテープ デバイスへのテープ バックアップをWindows。 Windows でサポートされるテープ デバイスの詳細については、Windows のハードウェア互換性リストを参照してください。 コンピューターで使用可能なテープ デバイスを表示するには、次のコマンドをSQL Server Management Studio。

ドライブの製造元から提案された特定のテープ ドライブに推奨されるテープのみを使用してください。 DAT (digital audio tape) ドライブを使用している場合は、コンピューター用の DAT テープ (Digital Data Storage-DDS) を使用してください。

sp_addumpdevice トランザクション内では実行できません。

デバイスを削除するには、sp_dropdevice またはSQL Server Management Studio

アクセス許可

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

ディスクに対する書き込み権限が必要です。

A. ディスク ダンプ デバイスの追加

次の例では、 という名前のディスク バックアップ デバイス mydiskdumpを物理名 で追加します c:\dump\dump1.bak

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'mydiskdump', 'c:\dump\dump1.bak';  

B. ネットワーク ディスク バックアップ デバイスの追加

次の例では、networkdevice というリモートのディスク バックアップ デバイスを追加します。 アプリケーションが起動されたデータベース エンジン、そのリモート ファイル () に対するアクセス許可が必要です\\<servername>\<sharename>\<path>\<filename>.bak

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'networkdevice',  
    '\\<servername>\<sharename>\<path>\<filename>.bak';  

C. テープ バックアップ デバイスを追加する

次の例では、物理名 tapedump1 を持つデバイスを追加します \\.\tape0

USE master;  
GO  
EXEC sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';  

D. 論理バックアップ デバイスへのバックアップ

次の例では、バックアップ ディスク ファイルの AdvWorksData論理バックアップ デバイス を作成します。 この例では、 AdventureWorks2012 データベースをこの論理バックアップ デバイスにバックアップします。

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'AdvWorksData',   
'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';  
GO  
BACKUP DATABASE AdventureWorks2012   
 TO AdvWorksData  
   WITH FORMAT;  
GO  

参照

バックアップ デバイス (SQL Server)
BACKUP (Transact-SQL)
ディスク ファイルの論理バックアップ デバイスの定義 (SQL Server)
テープ ドライブの論理バックアップ デバイスの定義 (SQL Server)
RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL)
sys.backup_devices (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)