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 來取得備份組所包含的檔案清單。這項資訊是傳回的結果集，其中包含每個檔案各一個資料列。

資料行名稱	資料類型	描述
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	檔案群組的識別碼。
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 選項指定裝置的第二個備份組。

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 協助