共用方式為

RESTORE 陳述式 - LABELONLY (Transact-SQL)

  • 發行項

適用於：SQL Server Azure SQL 受控執行個體

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

注意

如需引數的描述，請參閱 RESTORE 引數 (Transact-SQL)。

Transact-SQL 語法慣例

Syntax

  
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 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 工具進行不正確的還原。 它無法防止透過其他方式或以取代密碼的方式來讀取備份資料。 SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能，並計劃修改目前正在使用此功能的應用程式。保護備份的最佳做法，是將備份磁帶儲存在安全的位置，或將其備份到受適當存取控制清單 (ACL) 保護的磁碟檔案。 ACL 應該設在備份建立所在的根目錄下。

權限

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

另請參閱

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