RESTORE FILELISTONLY (Transact-SQL)
バックアップ セットに保存されているデータベースとログ ファイルのリストを含んだ結果セットを返します。
.gif "ms173778.note(ja-jp,SQL.90).gif") メモ : |
|---|
| 引数の説明については、「RESTORE の引数 (Transact-SQL)」を参照してください。 |
.gif "トピック リンク アイコン")
構文
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 オプションが使用された場合、メディアの上書きを防ぐことはできません。
.gif "ms173778.security(ja-jp,SQL.90).gif") セキュリティ メモ : |
|---|
| パスワードによる保護は強力なものではありません。パスワードによる保護は、権限の有無にかかわらず、ユーザーが 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)
その他の技術情報
メディア セット、メディア ファミリ、およびバックアップ セット
バックアップ情報の表示
ログ シーケンス番号の概要