RESTORE FILELISTONLY (Transact-SQL)
バックアップ セットに保存されているデータベースとログ ファイルのリストを含んだ結果セットを返します。
.gif "注意") 注 |
|---|
引数の説明については、「RESTORE の引数 (Transact-SQL)」を参照してください。 |
.gif "トピック リンク アイコン")
構文
RESTORE FILELISTONLY
FROM <backup_device>
[ WITH
{
--Backup Set Options
FILE = { backup_set_file_number | @backup_set_file_number }
| PASSWORD = { password | @password_variable }
--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 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 = ファイルはバックアップ済み。 |
TDEThumbprint |
varbinary(32) |
データベース暗号化キーの拇印を表示します。暗号化の拇印とは、キーの暗号化で使用された証明書の SHA-1 ハッシュです。データベースの暗号化の詳細については、「透過的なデータ暗号化 (TDE) について」を参照してください。 |
権限
SQL Server 2008 以降のバージョンでは、バックアップ セットやバックアップ デバイスに関する情報の取得には CREATE DATABASE 権限が必要になります。詳細については、「GRANT (データベースの権限の許可) (Transact-SQL)」を参照してください。
バックアップ操作では、オプションで、メディア セットとバックアップ セットにそれぞれパスワードを設定できます。メディア セットまたはバックアップ セットにパスワードが設定されている場合は、RESTORE ステートメントで正しいパスワードを指定する必要があります。これらのパスワードを設定しておくと、Microsoft SQL Server ツールを使って不正に復元操作が行われたり、メディアにバックアップ セットが不正に追加されるのを防ぐことができます。ただし、BACKUP ステートメントで FORMAT オプションが使用された場合、メディアの上書きを防ぐことはできません。
.gif "セキュリティに関する注意") セキュリティに関する注意 |
|---|
パスワードによる保護は強力なものではありません。パスワードによる保護は、権限の有無にかかわらず、ユーザーが SQL Server ツールを使用して不適切な復元を行わないようにすることを目的としています。その他の手段によるバックアップ データの読み取りやパスワードの置き換えを防ぐわけではありません。この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。バックアップ保護に最適な方法は、バックアップ テープを安全な場所に保管するか、バックアップしたディスク ファイルを適切なアクセス制御リスト (ACL) で保護することです。ACL は、バックアップを作成するディレクトリのルートに設定する必要があります。 |
例
次の例は、AdventureWorks2008R2Backups というバックアップ デバイスから情報を返します。この例では FILE オプションを使用して、デバイスで 2 番目のバックアップ セットを指定しています。
RESTORE FILELISTONLY FROM AdventureWorks2008R2Backups
WITH FILE=2;
GO