RESTORE HEADERONLY (Transact-SQL)

[アーティクル]
06/18/2013

特定のバックアップデバイス上にあるすべてのバックアップセットについて、すべてのバックアップヘッダー情報を含む結果セットを返します。

注
引数の説明については、「RESTORE の引数 (Transact-SQL)」を参照してください。

トピックリンクアイコン Transact-SQL 構文表記規則

構文

RESTORE HEADERONLY 
FROM <backup_device> 
[ WITH 
 {
--Backup Set Options
   FILE = { backup_set_file_number | @backup_set_file_number } 
 | PASSWORD = { password | @password_variable } 

--Media Set Options
 | MEDIANAME = { media_name | @media_name_variable } 
 | MEDIAPASSWORD = { mediapassword | @mediapassword_variable }

--Error Management Options
 | { CHECKSUM | NO_CHECKSUM } 
 | { STOP_ON_ERROR | CONTINUE_AFTER_ERROR }

--Tape Options
 | { REWIND | NOREWIND } 
 | { UNLOAD | NOUNLOAD }  
 } [ ,...n ]
]
[;]

<backup_device> ::=
{ 
   { logical_backup_device_name |
      @logical_backup_device_name_var }
   | { DISK | TAPE } = { 'physical_backup_device_name' |
       @physical_backup_device_name_var } 
}

引数

RESTORE HEADERONLY の引数の説明については、「RESTORE の引数 (Transact-SQL)」を参照してください。

結果セット

指定されたデバイス上にあるバックアップごとに、サーバーからヘッダー情報の行が送信されます。下に説明する列が含まれています。

注
RESTORE HEADERONLY では、メディア上のすべてのバックアップセットが確認されるため、大容量のテープドライブを使用している場合は結果セットの生成に時間がかかることがあります。バックアップセットごとの情報を取得せずにメディアの内容をすばやく確認するには、RESTORE LABELONLY を使用するか、FILE = backup_set_file_number を指定してください。

RESTORE HEADERONLY では、メディア上のすべてのバックアップセットが確認されるため、大容量のテープドライブを使用している場合は結果セットの生成に時間がかかることがあります。バックアップセットごとの情報を取得せずにメディアの内容をすばやく確認するには、RESTORE LABELONLY を使用するか、FILE = backup_set_file_number を指定してください。

注
Microsoft Tape Format の特性により、その他のソフトウェアプログラムから作成されたバックアップセットと Microsoft SQL Server のバックアップセットが同じメディア上に記録されている場合がありますが、 RESTORE HEADERONLY によって返される結果セットには、その他のバックアップセットの情報も 1 件につき 1 行ずつ含まれます。

Microsoft Tape Format の特性により、その他のソフトウェアプログラムから作成されたバックアップセットと Microsoft SQL Server のバックアップセットが同じメディア上に記録されている場合がありますが、 RESTORE HEADERONLY によって返される結果セットには、その他のバックアップセットの情報も 1 件につき 1 行ずつ含まれます。

BackupName

nvarchar(128)

バックアップセット名。

BackupDescription

nvarchar(255)

バックアップセットの説明。

BackupType

smallint

バックアップの種類。

1 = データベース

2 = トランザクションログ

4 = ファイル

5 = データベースの差分

6 = ファイルの差分

7 = 部分

8 = 部分的な差分

ExpirationDate

datetime

バックアップセットの失効日。

Compressed

BYTE(1)

ソフトウェアベースの圧縮によりバックアップセットが圧縮されているかどうか。

0 = いいえ

1 = はい

Position

smallint

ボリューム内でのバックアップセットの位置 (FILE = のオプションで使用)。

DeviceType

tinyint

バックアップ操作で使用するデバイスに対応する値。

ディスク:

2 = 論理

102 = 物理

テープ:

5 = 論理

105 = 物理

仮想デバイス:

7 = 論理

107 = 物理

論理デバイス名とデバイス番号は、sys.backup_devices で確認できます。詳細については、「sys.backup_devices (Transact-SQL)」を参照してください。

UserName

nvarchar(128)

バックアップ操作を実行したユーザーの名前。

ServerName

nvarchar(128)

バックアップセットを作成したサーバーの名前。

DatabaseName

nvarchar(128)

バックアップの作成元であるデータベースの名前。

DatabaseVersion

int

バックアップの作成元であるデータベースのバージョン。

DatabaseCreationDate

datetime

データベースが作成された日時。

BackupSize

numeric(20,0)

バックアップのサイズ (バイト単位)。

FirstLSN

numeric(25,0)

バックアップセット内にある先頭のログレコードのログシーケンス番号。

LastLSN

numeric(25,0)

バックアップセットの次のログレコードのログシーケンス番号。

CheckpointLSN

numeric(25,0)

バックアップが作成された時点における最新チェックポイントのログシーケンス番号。

DatabaseBackupLSN

numeric(25,0)

データベース全体の最新バックアップのログシーケンス番号。

DatabaseBackupLSN は、バックアップの開始時に発生した "チェックポイントの先頭" を表します。データベースがアイドル状態で、レプリケーションが構成されていないときにバックアップが実行された場合、このログシーケンス番号は FirstLSN と同じになります。

BackupStartDate

datetime

バックアップ操作が開始した日時。

BackupFinishDate

datetime

バックアップ操作が終了した日時。

SortOrder

smallint

サーバーの並べ替え順。この列はデータベースバックアップのみで有効です。これは旧バージョンとの互換性のために用意されています。

CodePage

smallint

サーバーが使用するサーバーコードページまたは文字セット。

UnicodeLocaleId

int

Unicode 文字データの並べ替えに使用する、サーバー Unicode ロケール ID 構成オプション。これは旧バージョンとの互換性のために用意されています。

UnicodeComparisonStyle

int

Unicode データの並べ替えに詳細な設定を追加できる、サーバー Unicode 比較スタイル構成オプション。これは旧バージョンとの互換性のために用意されています。

CompatibilityLevel

tinyint

バックアップの作成元であるデータベースの互換性レベル設定。

SoftwareVendorId

int

ソフトウェアベンダーの識別番号。 SQL Server の場合、この値は 4608 (16 進数では 0x1200) です。

SoftwareVersionMajor

int

バックアップセットを作成したサーバーのメジャーバージョン番号。

SoftwareVersionMinor

int

バックアップセットを作成したサーバーのマイナーバージョン番号。

SoftwareVersionBuild

int

バックアップセットを作成したサーバーのビルド番号。

MachineName

nvarchar(128)

バックアップ操作を実行したコンピューターの名前。

Flags

int

フラグの各ビットが 1 に設定された場合、フラグによって表される 10 進数の意味は次のとおりです。

1 = 一括ログ記録操作を含むログバッグアップ。

2 = スナップショットバックアップ。

4 = バックアップ時データベースが読み取り専用。

8 = バックアップ時データベースがシングルユーザーモード。

16 = バックアップチェックサムを含むバックアップ。

32 = データベースがバックアップ時に損傷したが、エラーに関係なくバックアップ操作の続行が要求された。

64 = ログ末尾のバックアップ。

128 = 不完全なメタデータでのログ末尾のバックアップ。

256 = NORECOVERY でのログ末尾のバックアップ。

重要
Flags ではなく、下に示す HasBulkLoggedData から IsCopyOnly までのブール値をとる各列の使用をお勧めします。

BindingID

uniqueidentifier

データベースに割り当てられたバインド ID。これは sys.database_recovery_status database_guid に対応します。データベースが復元されると、新しい値が割り当てられます。下の FamilyGUID も参照してください。

RecoveryForkID

uniqueidentifier

最後の復旧分岐の ID。この列は、backupset テーブル内の last_recovery_fork_guid に対応します。

データのバックアップでは、RecoveryForkID は FirstRecoveryForkID と同じです。

Collation

nvarchar(128)

データベースで使用されている照合順序。

FamilyGUID

uniqueidentifier

元のデータベースに関する作成時の ID。この値は、データベースが復元されても変わりません。

HasBulkLoggedData

bit

1 = 一括ログ記録操作を含むログバッグアップ。

IsSnapshot

bit

1 = スナップショットバックアップ。

IsReadOnly

bit

1 = バックアップ時、データベースが読み取り専用。

IsSingleUser

bit

1 = バックアップ時、データベースがシングルユーザーモード。

HasBackupChecksums

bit

1 = バックアップチェックサムを含むバックアップ。

IsDamaged

bit

1 = データベースがバックアップ時に損傷したが、エラーに関係なくバックアップ操作の続行が要求された。

BeginsLogChain

bit

1 = 連鎖的なログバックアップの先頭。データベースが作成された後、または単純復旧モデルが完全復旧モデルや一括ログ復旧モデルに切り替わった後、最初に行われるログバックアップを先頭にして、ログチェーンが形成されます。

HasIncompleteMetaData

bit

1 = 不完全なメタデータを使用したログ末尾のバックアップ。

不完全なバックアップメタデータを使用したログ末尾のバックアップについては、「ログ末尾のバックアップ (SQL Server)」を参照してください。

IsForceOffline

bit

1 = NORECOVERY を使用したバックアップ。データベースはバックアップによってオフラインになりました。

IsCopyOnly

bit

1 = コピーのみのバックアップ。

コピーのみのバックアップを行っても、データベースの全体的なバックアップと復元の手順に影響はありません。詳細については、「コピーのみのバックアップ (SQL Server)」を参照してください。

FirstRecoveryForkID

uniqueidentifier

最初の復旧分岐の ID。この列は、backupset テーブルの first_recovery_fork_guid に対応します。

データのバックアップでは、FirstRecoveryForkID は RecoveryForkID と同じです。

ForkPointLSN

numeric(25,0) NULL

FirstRecoveryForkID が RecoveryForkID と同じでない場合の、分岐ポイントのログシーケンス番号。これらが同じである場合、この値は NULL になります。

RecoveryModel

nvarchar(60)

データベースの復旧モデル。次のいずれかになります。

FULL

BULK-LOGGED

SIMPLE

DifferentialBaseLSN

numeric(25,0) NULL

シングルベースの差分バックアップの場合、差分ベースの FirstLSN と同じ値になります。DifferentialBaseLSN 以上のログシーケンス番号の変更は差分に取り込まれます。

マルチベースの差分バックアップの場合、この値は NULL です。ベースログシーケンス番号はファイルレベルで決定される必要があります。詳細については、「RESTORE FILELISTONLY (Transact-SQL)」を参照してください。

差分バックアップ以外の種類のバックアップの場合は常に NULL。

詳細については、「差分バックアップ (SQL Server)」を参照してください。

DifferentialBaseGUID

uniqueidentifier

シングルベースの差分バックアップの場合は、差分ベースの一意識別子。

マルチベースの差分バックアップの場合は、NULL。差分のベースはファイルごとに決定する必要があります。

差分バックアップ以外のバックアップの場合は NULL。

BackupTypeDescription

nvarchar(60)

バックアップの種類を表す文字列。次のいずれかになります。

DATABASE

TRANSACTION LOG

FILE OR FILEGROUP

DATABASE DIFFERENTIAL

FILE DIFFERENTIAL PARTIAL

PARTIAL DIFFERENTIAL

BackupSetGUID

uniqueidentifier NULL

メディア上のバックアップセットを識別する、バックアップセットの一意識別番号。

CompressedBackupSize

bigint

バックアップセットのバイト数。圧縮されていないバックアップの場合、この値は BackupSize と同じです。

圧縮比率を計算するには、CompressedBackupSize と BackupSize を使用します。

この値は、msdb のアップグレード中に、BackupSize 列の値に一致するように設定されます。

containment

tinyint (NULL 以外)

データベースの包含状態を示します。

0 = データベースの包含がオフ

1 = データベースは部分的な包含

注
バックアップセットにパスワードが定義されている場合、RESTORE HEADERONLY によって完全な情報が返されるのは、コマンドの PASSWORD オプションと同じパスワードが指定されているバックアップセットに対してのみです。また保護されていないバックアップセットについても、RESTORE HEADERONLY では完全な情報が返されます。メディア上にある、他のパスワードで保護されているバックアップセットについては、BackupName 列に '*Password Protected*' という文字列が設定され、他の列は NULL になります。

バックアップセットにパスワードが定義されている場合、RESTORE HEADERONLY によって完全な情報が返されるのは、コマンドの PASSWORD オプションと同じパスワードが指定されているバックアップセットに対してのみです。また保護されていないバックアップセットについても、RESTORE HEADERONLY では完全な情報が返されます。メディア上にある、他のパスワードで保護されているバックアップセットについては、BackupName 列に '***Password Protected***' という文字列が設定され、他の列は NULL になります。

全般的な解説

クライアントは RESTORE HEADERONLY を使用して、特定のバックアップデバイス上のすべてのバックアップについて、バックアップヘッダーに関するすべての情報を取得できます。バックアップデバイス上にあるバックアップごとに、ヘッダー情報が 1 行のデータとしてサーバーから送信されます。

セキュリティ

バックアップ操作では、オプションで、メディアセットとバックアップセットにそれぞれパスワードを設定できます。メディアセットまたはバックアップセットにパスワードが設定されている場合は、RESTORE ステートメントで正しいパスワードを指定する必要があります。これらのパスワードを設定しておくと、Microsoft SQL Server ツールを使って不正に復元操作が行われたり、メディアにバックアップセットが不正に追加されるのを防ぐことができます。ただし、BACKUP ステートメントで FORMAT オプションが使用された場合、メディアの上書きを防ぐことはできません。

セキュリティに関する注意
パスワードによる保護は強力なものではありません。パスワードによる保護は、権限の有無にかかわらず、ユーザーが SQL Server ツールを使用して不適切な復元を行わないようにすることを目的としています。その他の手段によるバックアップデータの読み取りやパスワードの置き換えを防ぐわけではありません。この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。バックアップ保護に最適な方法は、バックアップテープを安全な場所に保管するか、バックアップしたディスクファイルを適切なアクセス制御リスト (ACL) で保護することです。 ACL は、バックアップを作成するディレクトリのルートに設定する必要があります。

パスワードによる保護は強力なものではありません。パスワードによる保護は、権限の有無にかかわらず、ユーザーが SQL Server ツールを使用して不適切な復元を行わないようにすることを目的としています。その他の手段によるバックアップデータの読み取りやパスワードの置き換えを防ぐわけではありません。この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。バックアップ保護に最適な方法は、バックアップテープを安全な場所に保管するか、バックアップしたディスクファイルを適切なアクセス制御リスト (ACL) で保護することです。 ACL は、バックアップを作成するディレクトリのルートに設定する必要があります。

権限

SQL Server 2008 以降のバージョンでは、バックアップセットやバックアップデバイスに関する情報の取得には CREATE DATABASE 権限が必要になります。詳細については、「GRANT (データベースの権限の許可) (Transact-SQL)」を参照してください。

使用例

次の例では、ディスクファイル C:\AdventureWorks-FullBackup.bak のヘッダー情報を返します。

RESTORE HEADERONLY 
FROM DISK = N'C:\AdventureWorks-FullBackup.bak' 
WITH NOUNLOAD;
GO

次の方法で共有

RESTORE HEADERONLY (Transact-SQL)

構文

引数

結果セット

全般的な解説

セキュリティ

権限

使用例

関連項目

参照

概念

その他のリソース