RESTORE FILELISTONLY (Transact-SQL)

バックアップ セットに保存されているデータベースとログ ファイルのリストを含んだ結果セットを返します。

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

Transact-SQL 構文表記規則

構文

RESTORE FILELISTONLY 
FROM <backup_device> 
[ WITH 
   [ { CHECKSUM | NO_CHECKSUM } ]
   [ [ , ] { CONTINUE_AFTER_ERROR | STOP_ON_ERROR } ]
   [ [ , ] FILE = backup_set_file_number ] 
   [ [ , ] MEDIANAME = { media_name | @media_name_variable } ] 
   [ [ , ] MEDIAPASSWORD = { mediapassword |
                    @mediapassword_variable } ] 
   [ [ , ] PASSWORD = { password | @password_variable } ] 
   [ [ , ] REWIND ] 
   [ [ , ] { UNLOAD | NOUNLOAD } ]  
]
[;]

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

引数

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

結果セット

クライアントでは、RESTORE FILELISTONLY を使用して、バックアップ セットに含まれるファイルの一覧を取得できます。この情報は、ファイル 1 件あたり 1 行のデータで構成される結果セットとして返されます。

列名	データ型	説明
LogicalName	nvarchar(128)	ファイルの論理名。
PhysicalName	nvarchar(260)	ファイルの物理名またはオペレーティング システム名。
Type	char(1)	ファイルの種類。次のいずれかになります。 L = Microsoft SQL Server ログ ファイル D = SQL Server データ ファイル F = フルテキスト カタログ
FileGroupName	nvarchar(128)	このファイルを含むファイル グループの名前。
Size	numeric(20,0)	現在のサイズ (バイト単位)。
MaxSize	numeric(20,0)	最大許容サイズ (バイト単位)。
FileID	bigint	データベース内で一意なファイル識別子。
CreateLSN	numeric(25,0)	ファイルが作成されたときのログ シーケンス番号。
DropLSN	numeric(25,0) NULL	ファイルが削除されたときのログ シーケンス番号。ファイルが削除されていない場合、この値は NULL です。
UniqueID	uniqueidentifier	ファイルのグローバル一意識別子。
ReadOnlyLSN	numeric(25,0) NULL	このファイルを含むファイル グループが、前回読み書き可能から読み取り専用に変更されたときのログ シーケンス番号。
ReadWriteLSN	numeric(25,0) NULL	このファイルを含むファイル グループが、前回読み取り専用から読み書き可能に変更されたときのログ シーケンス番号。
BackupSizeInBytes	bigint	このファイルのバックアップ サイズ (バイト単位)。
SourceBlockSize	int	ファイルが格納されている物理デバイス (バックアップ デバイス以外) のバイト単位のブロック サイズ。
FileGroupID	int	ファイル グループの ID。
LogGroupGUID	uniqueidentifier NULL	NULL。
DifferentialBaseLSN	numeric(25,0) NULL	差分バックアップの場合、DifferentialBaseLSN 以上のログ シーケンス番号を持つ変更が差分に含まれます。 その他の種類のバックアップの場合、この値は NULL です。 ログ シーケンス番号 (LSN) の詳細については、「ログ シーケンス番号の概要」に記載されている概要説明を参照してください。
DifferentialBaseGUID	uniqueidentifier	差分ベースの一意識別子 (差分バックアップの場合)。 その他の種類のバックアップの場合、この値は NULL です。
IsReadOnly	bit	1 = ファイルは読み取り専用。
IsPresent	bit	1 = ファイルはバックアップ済み。

権限

すべてのユーザーが RESTORE FILELISTONLY を使用できます。

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

セキュリティ メモ :
パスワードによる保護は強力なものではありません。パスワードによる保護は、権限の有無にかかわらず、ユーザーが SQL Server 2005 ツールを使用して不適切な復元を行わないようにすることを目的としています。その他の手段によるバックアップ データの読み取りやパスワードの置き換えを防ぐわけではありません。バックアップ保護に最適な方法は、バックアップ テープを安全な場所に保管するか、バックアップしたディスク ファイルを適切なアクセス制御リスト (ACL) で保護することです。ACL は、バックアップを作成するディレクトリのルートに設定する必要があります。

例

次の例は、AdventureWorksBackups というバックアップ デバイスから情報を返します。この例では FILE オプションを使用して、デバイスで 2 番目のバックアップ セットを指定しています。

RESTORE FILELISTONLY FROM AdventureWorksBackups 
   WITH FILE=2;
GO

参照

関連項目

BACKUP (Transact-SQL)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)

その他の技術情報

メディア セット、メディア ファミリ、およびバックアップ セット
バックアップ情報の表示
ログ シーケンス番号の概要

ヘルプおよび情報

SQL Server 2005 の参考資料の入手