RESTORE LABELONLY (Transact-SQL)

傳回含有給定備份裝置所識別的備份媒體之相關資訊的結果集。

[!附註]

如需引數的描述,請參閱<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 Tape Format 媒體標籤

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 只會讀取媒體標頭,因此,即便使用高容量的磁帶裝置,這個陳述式的完成速度也很快。

權限

在 SQL Server 2008 及更新版本中,取得有關備份組或備份裝置的資訊需要 CREATE DATABASE 權限。如需詳細資訊,請參閱<GRANT 資料庫權限 (Transact-SQL)>。

備份作業可以選擇性地指定媒體集的密碼。定義了媒體集的密碼之後,您必須在 RESTORE 陳述式中指定正確的密碼。該密碼可以防止他人利用 MicrosoftSQL Server 工具,在未獲授權的情況下,在媒體上執行還原作業及附加備份組。不過,密碼無法防止使用者利用 BACKUP 陳述式的 FORMAT 選項來覆寫媒體。

安全性注意事項安全性注意事項

這個密碼所提供的保護很弱。這是為了防止已獲授權或未獲授權的使用者使用 SQL Server 工具進行不正確的還原。它無法防止透過其他方式或以取代密碼的方式來讀取備份資料。未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 保護備份的最佳作法是將備份磁帶存放在安全位置,或備份至適當的存取控制清單 (ACL) 所保護的磁碟檔案中。ACL 應該設在備份建立所在的根目錄下。