RESTORE 陳述式 - LABELONLY (Transact-SQL)

適用於: SQL Server Azure SQL 受控執行個體 Azure Synapse Analytics 平行處理資料倉儲

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

注意

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

安全性

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

重要

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

權限

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

另請參閱

BACKUP (Transact-SQL)
媒體集、媒體家族與備份組 (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
備份記錄與標頭資訊 (SQL Server)