RESTORE LABELONLY (Transact-SQL)

構文

RESTORE LABELONLY 
FROM <backup_device> 
[ WITH 
 {
--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 LABELONLY の引数の説明については、「RESTORE の引数 (Transact-SQL)」を参照してください。

結果セット

RESTORE LABELONLY の結果セットは 1 行のデータで構成され、次の情報が含まれています。

列名	データ型	説明
MediaName	nvarchar(128)	メディアの名前
MediaSetId	uniqueidentifier	メディア セットの一意な識別番号
FamilyCount	int	メディア セット内のメディア ファミリの数
FamilySequenceNumber	int	メディア ファミリのシーケンス番号
MediaFamilyId	uniqueidentifier	メディア ファミリの一意な識別番号
MediaSequenceNumber	int	メディア ファミリ内にあるメディアのシーケンス番号
MediaLabelPresent	tinyint	メディアの説明に含まれる内容 1 = Microsoft Tape Format メディア ラベル 0 = メディアの説明
MediaDescription	nvarchar(255)	自由形式のテキスト、または Tape Format メディア ラベルのメディアの説明
SoftwareName	nvarchar(128)	ラベルを作成したバックアップ ソフトウェアの名前
SoftwareVendorId	int	バックアップを作成したソフトウェア ベンダの一意なベンダ識別番号
MediaDate	datetime	ラベルが作成された日時
Mirror_Count	int	セットにあるミラーの数 (1 ～ 4) 注意 セット内の各ミラーに対して作成されたラベルは同一のものです。
IsCompressed	bit	バックアップが圧縮されているかどうか 0 = 非圧縮 1 = 圧縮

注意
目的のメディア セットにパスワードが定義されているとき、RESTORE LABELONLY では、MEDIAPASSWORD オプションに正しいメディア パスワードが指定された場合にのみ情報を返します。

説明

RESTORE LABELONLY を実行すると、バックアップ メディアに含まれている内容をすばやく確認できます。RESTORE LABELONLY ステートメントはメディア ヘッダーだけを読み取っているので、大容量のテープ デバイスを使用しているときでも処理が短時間で終了します。

権限

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

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

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

関連項目

参照

概念