RESTORE FILELISTONLY (Transact-SQL)
返回由备份集内包含的数据库和日志文件列表组成的结果集。
.gif "ms173778.note(zh-cn,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 获得备份集内的文件的列表。该信息以结果集的形式返回，在结果集中每个文件占一行。
| 列名 | 数据类型 | 说明 |
|---|---|---|
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(zh-cn,SQL.90).gif") 安全说明： |
|---|
| 此密码提供的安全性较低。它旨在防止经过授权的用户和未经授权的用户使用 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)