RESTORE LABELONLY (Transact-SQL)

バックアップ メディアについての情報が含まれている結果セットを返します。このバックアップ メディアは、指定したバックアップ デバイスで識別されるメディアです。

注意

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

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

セキュリティに関する注意セキュリティに関する注意

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