返回由有关给定备份设备所标识的备份媒体的信息组成的结果集。
RESTORE LABELONLY
FROM < backup_device >
[ WITH { NOUNLOAD | UNLOAD } ]
[ [ , ] MEDIAPASSWORD = { mediapassword | @mediapassword_variable } ]
< backup_device > ::=
{
{ 'logical_backup_device_name' | @logical_backup_device_name_var }
| { DISK | TAPE } =
{ 'physical_backup_device_name' | @physical_backup_device_name_var }
}
< backup_device >
指定还原时要使用的逻辑或物理备份设备。可以是下列选项之一：
允许从命名磁盘或磁带设备还原备份。磁盘或磁带的设备类型应该用设备的真实名称（例如：完整的路径和文件名）来指定：DISK = 'C:\Program Files\Microsoft SQL Server\MSSQL\BACKUP\Mybackup.dat' 或 TAPE = '\\.\TAPE0'。如果指定为变量 (@physical_backup_device_name_var)，则设备名可以是字符串常量 (@physical_backup_device_name_var = 'physical_backup_device_name') 或字符串数据类型（ntext 或 text 数据类型除外）的变量。
如果使用的是含有 UNC 名称的网络服务器或已重新定向的驱动器号，则请指定磁盘的设备类型。
NOUNLOAD
指定不在还原后从磁带机中自动卸载磁带。设置始终为 NOUNLOAD，直到指定 UNLOAD 为止。该选项只用于磁带设备。
UNLOAD
指定在还原完成后自动倒带并卸载磁带。启动新用户会话时其默认设置为 UNLOAD。设置始终为 UNLOAD，直到指定 NOUNLOAD 为止。该选项只用于磁带设备。
MEDIAPASSWORD = { mediapassword | @mediapassword_variable}
是媒体集的密码。MEDIAPASSWORD 是一个字符串。
如果格式化媒体集时提供了密码，则在该媒体集上创建备份集时必须提供密码。另外，从该媒体集执行任何还原操作时也必须提供媒体密码。
RESTORE LABELONLY 返回的结果集由包含下列信息的一行组成。
| 列名 | 数据类型 | 描述 |
|---|---|---|
| MediaName | nvarchar(128) | 媒体的名称。 |
| MediaSetId | uniqueidentifier | 媒体集的唯一标识号。如果媒体集中只有一个媒体家族，则该列的值为 NULL。 |
| FamilyCount | int | 媒体集中的媒体家族数。 |
| FamilySequenceNumber | int | 该媒体家族的序号。 |
| MediaFamilyId | uniqueidentifier | 媒体家族的唯一标识号。 |
| MediaSequenceNumber | int | 该媒体在媒体家族中的序号。 |
| MediaLabelPresent | tinyint | 媒体描述中是否包含：
1 = Microsoft 磁带格式媒体 |
| MediaDescription | nvarchar(255) | 媒体描述，以自由格式文本或 Microsoft 磁带格式媒体标签格式。 |
| SoftwareName | nvarchar(128) | 写入标签的备份软件名称。 |
| SoftwareVendorId | int | 写入备份的软件供应商唯一供应商标识号。 |
| MediaDate | datetime | 标签的写入日期和时间。 |
说明 如果为媒体集定义了密码，则只有在命令的MEDIAPASSWORD 选项中指定了正确的媒体密码时，RESTORE LABELONLY 才返回信息。
任何用户都可以使用 RESTORE LABELONLY。
此外，用户可以为媒体集、备份集或两者指定密码。如果为媒体集指定了密码，则用户若只是适当的固定服务器和数据库角色成员还不足以执行备份。用户还必须提供媒体密码才能执行这些操作。同样，除非在还原命令中指定正确的媒体集密码和备份集密码，否则不能执行还原操作。
在 BACKUP 语句中，定义备份集密码和媒体集密码为可选功能。使用密码可防止利用 SQL Server 2000 工具未经授权地执行还原操作和在媒体中添加备份集，但是，密码不能防止通过 FORMAT 选项重写媒体。
因此，尽管使用密码对防止利用 SQL Server 工具未经授权地访问媒体内容有帮助，但密码不能防止媒体内容被破坏。密码不能完全防止未经授权地访问媒体内容，原因在于备份集中的数据没有加密，理论上可以被专为此目的创建的程序所检查。对于安全性至关重要的场合，防止未经授权的个人访问媒体非常重要。
指定密码时不限定使用者的做法是错误的。
执行 RESTORE LABELONLY 是找出备份媒体所含内容的快速方法。RESTORE LABELONLY 只读取媒体首部，因此即使在使用高容量磁带设备时该语句也执行得很快。