sp_addumpdevice (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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実行されたときにのみ行われます。 論理バックアップ デバイスを作成すると、簡単にRESTOREBACKUP記述できます。ここで、デバイス名を指定することは、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

関連するコンテンツ