RESTORE LABELONLY (Transact-SQL)

项目
06/18/2013

返回一个结果集，它包含给定备份设备识别的备份介质的相关信息。

注意
有关参数的说明，请参阅 RESTORE 参数 (Transact-SQL)。

主题链接图标 Transact-SQL 语法约定

语法

RESTORE LABELONLY 
FROM <backup_device> 
[ WITH 
 {
--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 LABELONLY 参数的说明，请参阅 RESTORE 参数 (Transact-SQL)。

结果集

RESTORE LABELONLY 的结果集包含提供下列信息的一个行。

MediaName

nvarchar(128)

介质的名称。

MediaSetId

uniqueidentifier

介质集的唯一标识号。

FamilyCount

int

介质集中的介质簇数。

FamilySequenceNumber

int

此介质簇的序号。

MediaFamilyId

uniqueidentifier

介质簇的唯一标识号。

MediaSequenceNumber

int

此介质在介质簇中的序号。

MediaLabelPresent

tinyint

介质说明中是否包含：

1 = Microsoft 磁带格式介质标签

0= 介质说明

MediaDescription

nvarchar(255)

介质说明（自由格式的文本）或磁带格式介质标签。

SoftwareName

nvarchar(128)

写入标签的备份软件名称。

SoftwareVendorId

int

写入备份的软件供应商的唯一供应商标识号。

MediaDate

datetime

标签的写入日期和时间。

Mirror_Count

int

介质集中的镜像服务器数 (1-4)。

注意
在介质集中为不同镜像服务器写入的标签是相同的。

IsCompressed

bit

备份是否已压缩：

0 = 未压缩

1 = 已压缩

注意
如果为介质集定义了密码，则只有在命令的 MEDIAPASSWORD 选项中指定了正确的介质密码时，RESTORE LABELONLY 才会返回信息。

一般备注

执行 RESTORE LABELONLY 是一种查找备份介质所含内容的快速方法。由于 RESTORE LABELONLY 只读取介质标头，因此，即使使用高容量磁带设备，该语句的执行速度也会非常快。

安全性

备份操作可以有选择地指定介质集的密码。如果为介质集定义了密码，则必须在 RESTORE 语句中指定正确的密码。此密码可防止在未经授权的情况下使用 Microsoft SQL Server 工具执行还原操作以及向介质追加备份集。但是，密码不会阻止使用 BACKUP 语句的 FORMAT 选项覆盖介质。

安全说明
此密码提供的安全性较低。它旨在防止经过授权的用户或未经授权的用户使用 SQL Server 工具执行不正确的还原操作。但是不能防止通过其他方式或通过替换密码来读取备份数据。后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。保护备份的最佳做法是将备份磁带存储在安全的位置，或者备份到由适当的访问控制列表 (ACL) 保护的磁盘文件。应在创建备份的根目录中设置 ACL。

此密码提供的安全性较低。它旨在防止经过授权的用户或未经授权的用户使用 SQL Server 工具执行不正确的还原操作。但是不能防止通过其他方式或通过替换密码来读取备份数据。后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。保护备份的最佳做法是将备份磁带存储在安全的位置，或者备份到由适当的访问控制列表 (ACL) 保护的磁盘文件。应在创建备份的根目录中设置 ACL。