sp_addumpdevice (Transact-SQL)
適用対象:SQL Server
SQL Server のインスタンスにバックアップ デバイスを追加します。
構文
sp_addumpdevice
[ @devtype = ] 'devtype'
, [ @logicalname = ] N'logicalname'
, [ @physicalname = ] N'physicalname'
[ , [ @cntrltype = ] cntrltype ]
[ , [ @devstatus = ] 'devstatus' ]
[ ; ]
引数
[ @devtype = ] 'devtype'
バックアップ デバイスの種類。 @devtypeは varchar(20) で、既定値はなく、次のいずれかの値を指定できます。
Value | 説明 |
---|---|
disk |
バックアップ デバイスとしてのハード ディスク ファイル。 |
tape |
Microsoft Windows でサポートされているテープ デバイス。 注: テープ バックアップ デバイスのサポートは、今後のバージョンの SQL Server で削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 |
[ @logicalname = ] N'logicalname'
BACKUP ステートメントおよび RESTORE ステートメントで使用されるバックアップ デバイスの論理名。 @logicalnameは sysname で、既定値はなく、NULL
.
[ @physicalname = ] N'physicalname'
バックアップ デバイスの物理名。 @physicalnameは nvarchar(260) で、既定値はなく、使用できませんNULL
。 物理名は、オペレーティング システム ファイル名の規則またはネットワーク デバイスの汎用名前付け規則に従う必要があり、完全なパスを含める必要があります。
リモート ネットワークの場所にバックアップ デバイスを作成するときは、データベース エンジンが開始された名前にリモート コンピューター上の適切な書き込み機能があることを確認してください。
テープ デバイスを追加する場合、このパラメーターは Windows によってローカル テープ デバイスに割り当てられた物理名である必要があります。たとえば、 \\.\TAPE0
コンピューター上の最初のテープ デバイスの場合などです。 テープ デバイスをサーバー コンピューターに接続する必要があります。リモートで使用することはできません。 英数字以外の文字を含む名前を引用符で囲みます。
Note
この手順では、指定した物理名をカタログに入力します。 この手順では、デバイスへのアクセスや作成は試行されません。
[ @cntrltype = ] cntrltype
互換性のために残されています。 指定した場合、このパラメーターは無視されます。 下位互換性のためにサポートされています。 新しく使用 sp_addumpdevice
するパラメーターは省略する必要があります。
[ @devstatus = ] 'devstatus'
互換性のために残されています。 指定した場合、このパラメーターは無視されます。 下位互換性のためにサポートされています。 新しく使用 sp_addumpdevice
するパラメーターは省略する必要があります。
リターン コードの値
0
(成功) または 1
(失敗)。
結果セット
ありません。
解説
sp_addumpdevice
は、バックアップ デバイスをカタログ ビューに sys.backup_devices
追加します。 その後、デバイスを論理的に in BACKUP
ステートメントと RESTORE
呼びます。 sp_addumpdevice
では、物理デバイスへのアクセスは実行されません。 指定されたデバイスへのアクセスは、またはRESTORE
ステートメントがBACKUP
実行されたときにのみ行われます。 論理バックアップ デバイスを作成すると、簡単にRESTORE
BACKUP
記述できます。ここで、デバイス名を指定することは、or DISK =
句を使用してTAPE =
デバイス パスを指定する代わりの方法です。
所有権とアクセス許可の問題は、ディスクまたはファイル バックアップ デバイスの使用を妨げる可能性があります。 データベース エンジンが開始された Windows アカウントに適切なファイルアクセス許可が付与されていることを確認します。
データベース エンジンは、Windows でサポートされているテープ デバイスへのテープ バックアップをサポートします。 Windows でサポートされるテープ デバイスの詳細については、Windows のハードウェア互換性リストを参照してください。 コンピューターで使用可能なテープ デバイスを表示するには、SQL Server Management Studio を使用します。
ドライブの製造元が提案する特定のテープ ドライブに推奨されるテープのみを使用します。 デジタル オーディオ テープ (DAT) ドライブを使用している場合は、コンピューター グレードの DAT テープ (デジタル データ ストレージ (DDS)) を使用します。
sp_addumpdevice
はトランザクション内で実行できません。
デバイスを削除するには、sp_dropdeviceまたはバックアップ デバイスの削除 (SQL Server) を使用します。
アクセス許可
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
バックアップ ディスク ファイル用の論理バックアップ デバイスを作成します。 作成した論理バックアップ デバイスに AdventureWorks2022
データベースをバックアップします。
USE master;
GO
EXEC sp_addumpdevice
'disk',
'AdvWorksData',
'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO
BACKUP DATABASE AdventureWorks2022
TO AdvWorksData WITH FORMAT;
GO
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示