RESTORE の引数 (Transact-SQL)

以下のオプションは、復元操作の動作に影響します。

• MOVE 'logical_file_name_in_backup' TO 'operating_system_file_name' [ ...n ]
  使用できるステートメント: RESTORE および RESTORE VERIFYONLY

  logical_file_name_in_backup で論理名が指定されるデータ ファイルまたはログ ファイルを、復元時、operating_system_file_name で指定される位置に移動します。バックアップ セット内のデータ ファイルまたはログ ファイルの論理ファイル名は、バックアップ セットが作成されたときのデータベース内における論理名と同じです。

  n は追加の MOVE ステートメントを指定できることを示すプレースホルダーです。バックアップ セットから新しい位置に復元する論理ファイルごとに、MOVE ステートメントを指定してください。既定では、logical_file_name_in_backup ファイルは元の位置に復元されます。

  注
  バックアップ セットに含まれる論理ファイルの一覧を取得するには、RESTORE FILELISTONLY を使用します。

  RESTORE ステートメントを使用して、データベースを同じサーバーに再配置したり、別のサーバーにコピーするとき、データベース ファイルの再配置によって既存ファイルとの衝突が発生するのを防ぐために、MOVE オプションが必要になる場合があります。

  RESTORE LOG で MOVE オプションを使用する場合は、復元するログの対象期間中に追加されたファイルを再配置するためにのみ使用してください。たとえば、ログ バックアップにファイル file23 のファイル追加操作が含まれる場合、このファイルは RESTORE LOG で MOVE オプションを使って再配置します。

  RESTORE VERIFYONLY ステートメントを使用して、データベースを同じサーバーに再配置するか別のサーバーにコピーする場合は、対象となるサーバーに利用可能な容量が十分あるかどうか、および既存のファイルと衝突する可能性がないかどうかを確認するために、MOVE オプションが必要になる場合があります。

  詳細については、「バックアップと復元によるデータベースのコピー」を参照してください。

• REPLACE
  使用できるステートメント: RESTORE

  指定したデータベースと同じ名前のデータベースが既に存在していても、SQL Server でデータベースとその関連ファイルを作成することを指定します。この場合、既存のデータベースは削除されます。REPLACE オプションを指定しない場合、安全性チェックが行われます。これにより、他のデータベースを誤って上書きするのを防止できます。安全性チェックで次の両方に該当した場合は、RESTORE DATABASE ステートメントで現在のサーバーにデータベースが復元されることはありません。

  • RESTORE ステートメントで指定したデータベースが、現在のサーバー上に既に存在する。

  • データベース名が、バックアップ セットに記録されているデータベース名と異なる。

  REPLACE を指定すると、既存のファイルが復元するデータベースに属するかどうかを確認できない場合も、RESTORE でそのファイルを上書きできます。通常、RESTORE では既存のファイルは上書きされません。WITH REPLACE は、RESTORE LOG オプションと同じ方法で使用することもできます。

  REPLACE を使用すると、データベースを復元する前のログ末尾のバックアップも必須ではなくなります。

  詳細については、「REPLACE オプションの使用」を参照してください。

• RESTART
  使用できるステートメント: RESTORE

  SQL Server で中断されていた復元操作を再開することを指定します。RESTART では、中断された時点から復元操作が再開されます。

• RESTRICTED_USER
  使用できるステートメント: RESTORE

  新しく復元したデータベースへのアクセスを、db_owner、dbcreator、sysadmin の各ロールのメンバーに制限します。RESTRICTED_USER は、DBO_ONLY に置き換わるオプションです。DBO_ONLY は、SQL Server 2008 で廃止されました。

  RECOVERY オプションと共に使用します。

  詳細については、「データベース オプションの設定」を参照してください。

以下のオプションは、復元されるバックアップを含んでいるバックアップ セットに適用されます。

• FILE ={ backup_set_file_number | **@**backup_set_file_number }
  使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、および RESTORE VERIFYONLY

  復元するバックアップ セットを特定します。たとえば、backup_set_file_number が 1 の場合はバックアップ メディアの 1 番目のバックアップ セットを示し、backup_set_file_number が 2 の場合は 2 番目のバックアップ セットを示します。バックアップ セットの backup_set_file_number は、RESTORE HEADERONLY ステートメントを使用して取得できます。

  値を指定しない場合は、RESTORE HEADERONLY を除き、既定値の 1 が使用されます。RESTORE HEADERONLY では、メディア セットにあるすべてのバックアップ セットが処理されます。詳細については、後の「バックアップ セットの指定」を参照してください。

  重要
  この FILE オプションはデータベース ファイルを指定する FILE オプション (FILE = { logical_file_name_in_backup | @logical_file_name_in_backup_var }) とは関連はありません。

• PASSWORD = { password | **@**password_variable }
  使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、および RESTORE VERIFYONLY

  バックアップ セットのパスワードを指定します。バックアップ セットのパスワードは文字列です。

  注
  この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。

  バックアップ セットの作成時にパスワードを設定した場合、このバックアップ セットから復元操作を実行するときにはそのパスワードが必要になります。間違ったパスワードを指定した場合や、パスワードが設定されていないバックアップ セットにパスワードを指定した場合はエラーになります。

  重要
  このパスワードは、メディア セットを保護する手段としては強力なものではありません。詳細については、各ステートメントの「権限」を参照してください。

以下のオプションは、メディア セット全般に適用されます。

• MEDIANAME = { media_name | **@**media_name_variable}
  使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、RESTORE LABELONLY、および RESTORE VERIFYONLY

  メディアの名前を指定します。メディア名を指定する場合、その名前がバックアップ ボリューム上のメディア名と一致している必要があります。一致していない場合、復元操作は終了します。RESTORE ステートメントにメディア名を指定しない場合は、バックアップ ボリューム上のメディア名と一致するかどうかの確認は行われません。

  重要
  バックアップ操作と復元操作で同じメディア名を一貫して使用することで、復元操作で選択されたメディアに対する安全性チェックが強化されます。

• MEDIAPASSWORD = { mediapassword | **@**mediapassword_variable }
  使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、RESTORE LABELONLY、および RESTORE VERIFYONLY

  メディア セットのパスワードを指定します。メディア セットのパスワードは文字列です。

  注
  この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。

  メディア セットのフォーマット時にパスワードを設定した場合、メディア セット上のバックアップ セットにアクセスするときにはそのパスワードが必要になります。間違ったパスワードを指定した場合や、パスワードが設定されていないメディア セットにパスワードを指定した場合はエラーになります。

  重要
  このパスワードは、メディア セットを保護する手段としては強力なものではありません。詳細については、各ステートメントの「権限」を参照してください。

• BLOCKSIZE = { blocksize | **@**blocksize_variable }
  使用できるステートメント: RESTORE

  物理ブロック サイズをバイト単位で指定します。サポートされるサイズは、512、1024、2048、4096、8192、16384、32768、および 65536 (64 KB) バイトです。テープ デバイスの場合の既定値は 65536 バイトで、他のデバイスの場合の既定値は 512 バイトです。通常は、RESTORE でデバイスに適するブロック サイズが自動的に選択されるので、このオプションは不要です。ブロック サイズは、自動的に選択された値よりも明示的に指定された値が優先されます。

  CD-ROM からバックアップを復元する場合は、BLOCKSIZE=2048 と指定します。

  注
  このオプションがパフォーマンスに影響するのは、通常、テープ デバイスから読み取るときだけです。

このオプションでは、バックアップ デバイスからのデータ転送を最適化できます。

• BUFFERCOUNT = { buffercount | **@**buffercount_variable }
  使用できるステートメント: RESTORE

  復元操作に使用される I/O バッファーの総数を指定します。任意の正の整数を指定できますが、バッファー数が多いと Sqlservr.exe プロセスで仮想アドレス空間が不足し、"メモリ不足" エラーの原因となる場合があります。

  バッファーで使用される仮想アドレス空間の合計は、buffercount*****maxtransfersize の計算によって算出されます。

• MAXTRANSFERSIZE = { maxtransfersize | **@**maxtransfersize_variable }
  使用できるステートメント: RESTORE

  バックアップ メディアと SQL Server の間で使用される最大転送単位をバイト単位で指定します。有効値は 65536 バイト (64 KB) の倍数で、最大有効値は 4194304 バイト (4 MB) です。

このオプションでは、復元操作でバックアップのチェックサムを有効にするかどうか、およびエラー発生時に操作を停止するかどうかを指定できます。

• { CHECKSUM | NO_CHECKSUM }
  使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、RESTORE LABELONLY、および RESTORE VERIFYONLY

  既定の動作では、チェックサムがある場合はチェックサムの確認が行われ、チェックサムがない場合は確認せずに動作が続行されます。

  • CHECKSUM
    バックアップ チェックサムを必ず確認することを指定します。バックアップにバックアップ チェックサムがない場合、復元操作は失敗し、チェックサムがないことを示すメッセージが返されます。

    注
    ページ チェックサムは、バックアップ チェックサムが使用されている場合にのみバックアップ操作に関連します。

    既定では、無効なチェックサムが検出されると、RESTORE によってチェックサム エラーがレポートされ処理が停止しますが、CONTINUE_AFTER_ERROR を指定した場合は、破損による影響がない限り、チェックサム エラーと無効なチェックサムを含むページ番号が返された後、処理が続行します。

    バックアップ チェックサムの使用方法の詳細については、「バックアップ中および復元中のメディア エラーの検出と処置」を参照してください。

  • NO_CHECKSUM
    復元操作によるチェックサムの検証を、明示的に無効にします。

• { STOP_ON_ERROR | CONTINUE_AFTER_ERROR }
  使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、RESTORE LABELONLY、および RESTORE VERIFYONLY

  • STOP_ON_ERROR
    最初にエラーが発生した時点で、復元操作を停止することを指定します。これは RESTORE の既定の動作ですが、VERIFYONLY では既定の動作ではありません。VERIFYONLY の既定の動作は、CONTINUE_AFTER_ERROR になります。

  • CONTINUE_AFTER_ERROR
    エラーが発生した後も、復元操作を続行することを指定します。

    エラーが発生しても続行する場合の詳細については、「バックアップの破損による SQL Server 復元エラーの対応」を参照してください。

    バックアップに破損したページが含まれている場合は、エラーがない別のバックアップ、たとえばページが破損する前に作成したバックアップなどを使用して、復元操作をもう一度実行することをお勧めします。ただし、最終的な手段として、復元ステートメントの CONTINUE_AFTER_ERROR オプションを使用して破損したバックアップを復元し、データの復旧を試みることもできます。

このオプションでは、バックアップ デバイスからのデータ転送を監視できます。

• STATS [ = percentage ]
  使用できるステートメント: RESTORE および RESTORE VERIFYONLY

  指定したパーセンテージが完了するたびにメッセージを表示します。進行状況を判断する場合に使用できます。percentage を省略した場合、SQL Server では約 10% 完了するごとにメッセージが表示されます。

  STATS オプションでは、次のパーセンテージをレポートするためのしきい値に達した時点で、完了したパーセンテージがレポートされます。このしきい値は、指定したパーセンテージを正確に反映するものではありません。たとえば、STATS=10 の場合、データベース エンジンでは正確に 40% ではなく、43% の時点でメッセージが表示される場合があります。大きいバックアップ セットの場合、これは重要な問題にはなりません。それは、完了した I/O コール間の完了パーセンテージの差異はそれほど大きくないためです。

このオプションはテープ デバイスにのみ適用されます。テープ以外のデバイスが使用される場合、このオプションは無視されます。

• { REWIND | NOREWIND }
  このオプションはテープ デバイスにのみ適用されます。テープ以外のデバイスが使用される場合、このオプションは無視されます。

  • REWIND
    使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、RESTORE LABELONLY、および RESTORE VERIFYONLY

    SQL Server でテープを解放して巻き戻します。既定値は REWIND です。

  • NOREWIND
    使用できるステートメント: RESTORE および RESTORE VERIFYONLY

    これ以外の復元ステートメントで NOREWIND を指定するとエラーが発生します。

    SQL Server でバックアップ操作の後テープを開いたままにしておくことを指定します。このオプションを使用すると、1 つのテープに対して複数のバックアップ操作を実行する場合のパフォーマンスを向上できます。

    NOREWIND は暗黙的に NOUNLOAD も意味しています。この 2 つのオプションを同一の RESTORE ステートメント内で同時に使用することはできません。

    注
    NOREWIND を使用する場合、テープ ドライブの所有権は SQL Server インスタンスによって保持されます。同じプロセス内で実行される BACKUP ステートメントや RESTORE ステートメントで REWIND オプションまたは UNLOAD オプションが使用されるか、サーバー インスタンスがシャットダウンすると、所有権は解放されます。テープを開いたままにすると、他のプロセスはそのテープにアクセスできません。開いているテープの一覧を表示する方法、および開いているテープを閉じる方法については、「バックアップ デバイス」を参照してください。

• { UNLOAD | NOUNLOAD }
  使用できるステートメント: RESTORE、RESTORE FILELISTONLY、RESTORE HEADERONLY、RESTORE LABELONLY、RESTORE REWINDONLY、および RESTORE VERIFYONLY

  このオプションはテープ デバイスにのみ適用されます。テープ以外のデバイスが使用される場合、このオプションは無視されます。

  注
  UNLOAD または NOUNLOAD はセッションの設定であり、セッションが終了するまで、または代わりとなるオプションの指定によりリセットされるまで有効です。

  • UNLOAD
    バックアップ完了後、テープの巻き戻しおよびアンロードを自動的に行うことを指定します。UNLOAD はセッション開始時の既定の設定です。

  • NOUNLOAD
    RESTORE 操作の後、テープ ドライブにテープを読み込んだままにすることを指定します。