返回一个结果集，它包含给定备份设备识别的备份介质的相关信息。
注意
关于论证的描述，请参见 RESTORE 论证（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 | URL } = { 'physical_backup_device_name' |
@physical_backup_device_name_var }
}
注意
URL 是用于为 Microsoft Azure Blob 存储指定位置和文件名的格式，从 SQL Server 2012 (11.x) SP1 CU2 开始受支持。 虽然 Microsoft Azure 存储是一种服务，不过实现与磁盘和磁带类似，从而可为所有三种设备提供一致且无缝的还原体验。
参数
关于论证的 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 | 日期/时间 | 标签的写入日期和时间。 |
| Mirror_Count | int | 介质集中的镜像服务器数 (1-4)。 注意：在媒体集中为不同镜像服务器写入的标签是相同的。 |
| IsCompressed | 位 | 备份是否已压缩： 0 = 未压缩 1 = 已压缩 |
注意
如果为媒体集定义了密码，只有在命令的 MEDIAPASSWORD 选项中指定了正确的媒体密码时，才返回 RESTORE LABELONLY 信息。
一般备注
执行 RESTORE LABELONLY 是快速了解备份介质内容的好方法。 由于 RESTORE LABELONLY 只读取媒体头部，即使使用大容量磁带设备，该语句也能很快完成。
安全性
备份操作可以有选择地指定介质集的密码。 当媒体集上定义了密码后，你必须在语句中 RESTORE 指定正确的密码。 该密码可防止未经授权而使用 Microsoft SQL Server 工具执行还原操作以及向介质追加备份集。 然而，密码并不能阻止使用 BACKUP 语句中的FORMAT选项覆盖媒体。
重要
此密码提供的安全性较低。 它旨在防止经过授权的用户或未经授权的用户使用 SQL Server 工具执行不正确的还原操作。 但是不能防止通过其他方式或通过替换密码来读取备份数据。 在 SQL Server的未来版本中将删除此功能。 避免在新开发工作中使用此功能，并计划修改当前使用此功能的应用程序。 保护备份的最佳做法是将备份磁带存储在安全位置或备份到受适当访问控制列表（ACL）保护的磁盘文件。 ACL 应设置在创建备份的根目录下。
权限
在 SQL Server 2008（10.0.x）及更高版本中，获取有关备份集或备份设备的信息需要CREATE DATABASE权限。 有关详细信息，请参阅GRANT数据库权限（Transact-SQL）。
另请参阅
BACKUP （Transact-SQL）
介质集、介质簇和备份集 (SQL Server)
RESTORE REWINDONLY （Transact-SQL）
RESTORE VERIFYONLY （Transact-SQL）
RESTORE （Transact-SQL）
备份历史记录和标头信息 (SQL Server)