RESTORE 声明 - LABELONLY (Transact-SQL)

適用対象:SQL Server Azure SQL Managed Instance

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

注意

議論の説明については、 RESTORE Arguments (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 | URL } = { 'physical_backup_device_name' |  
       @physical_backup_device_name_var }   
}

注意

URL は、Microsoft Azure Blob Storage の場所とファイル名を指定するために使用される形式であり、SQL Server 2012 (11.x) SP1 CU2 以降でサポートされています。 Microsoft Azure ストレージはサービスですが、実装はディスクやテープと似ており、3 つのデバイスすべてで一貫したシームレスな復元エクスペリエンスを実現できます。

引数

RESTORE LABELONLY論証の説明については、RESTORE Arguments (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	ビット	バックアップが圧縮されているかどうか。 0 = 非圧縮 1 = 圧縮

注意

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

全般的な解説

RESTORE LABELONLYを実行することで、バックアップメディアの内容を素早く確認できます。 RESTORE LABELONLYメディアヘッダーのみを読み込むため、この文は大容量テープ機器を使用していてもすぐに終了します。

セキュリティ

バックアップ操作では、メディアセットのパスワードを指定することもできます。メディアセットでパスワードが定義された場合、 RESTORE 文で正しいパスワードを指定しなければなりません。このパスワードによって、Microsoft SQL Server ツールを使用して不正に復元操作が行われたり、メディアにバックアップセットが不正に追加されたりするのを防ぎます。しかし、パスワードがあっても BACKUP 文のFORMATオプションによるメディアの上書きを防ぐことはできません。

重要

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

アクセス許可

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

参照

BACKUP (Transact-SQL)
メディアセット、メディアファミリ、およびバックアップセット (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
バックアップの履歴とヘッダーの情報 (SQL Server)

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-06-24