Инструкции RESTORE — LABELONLY (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

Возвращает результирующий набор, содержащий сведения о носителях резервного копирования, которые определяются данным устройством резервного копирования.

Примечание.

Описания аргументов см. в статье Аргументы инструкций 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-адрес — это формат, который используется для указания расположения и имени файла для хранилища BLOB-объектов Microsoft Azure и поддерживается начиная с SQL Server 2012 (11.x) SP1 CU2. Хотя хранилище Microsoft Azure является службой, реализация аналогична дисковому и ленточному хранилищу, чтобы обеспечить единообразное и эффективное восстановление для всех трех устройств.

Аргументы

Описания аргументов инструкции RESTORE LABELONLY см. в статье Аргументы инструкций RESTORE (Transact-SQL).

Результирующие наборы

Результирующий набор инструкции RESTORE LABELONLY состоит из единственной строки со следующими сведениями.

Имя столбца Тип данных Description
MediaName nvarchar(128) Имя носителя.
MediaSetId uniqueidentifier Уникальный идентификационный номер набора носителей.
FamilyCount int Число семейств носителей в наборе носителей.
FamilySequenceNumber int Порядковый номер данного семейства.
MediaFamilyId uniqueidentifier Уникальный идентификационный номер семейства носителей.
MediaSequenceNumber int Порядковый номер конкретного носителя в семействе носителей.
MediaLabelPresent tinyint Содержит ли описание носителя:

1 = метка носителя Microsoft Tape Format

0 = Описание носителя
MediaDescription nvarchar(255) Описание носителя в произвольной текстовой форме или метка носителя Tape Format.
SoftwareName nvarchar(128) Имя программы резервного копирования, записавшей метку.
SoftwareVendorId int Уникальный идентификационный номер поставщика программы, записавшей резервную копию.
MediaDate datetime Дата и время записи метки.
Mirror_Count int Количество зеркал в наборе (1 — 4).

Примечание: метки, записанные для различных зеркал в наборе, идентичны.
IsCompressed bit Указывает, является ли резервная копия сжатой:

0 = не сжатая;

1 = сжатая.

Примечание.

Если для набора носителей определен пароль, инструкция RESTORE LABELONLY возвращает сведения только в том случае, если в аргументе MEDIAPASSWORD задан правильный пароль.

Общие замечания

Выполнение инструкции RESTORE LABELONLY является быстрым способом узнать, что содержит носитель резервной копии. Поскольку инструкция RESTORE LABELONLY считывает только заголовок носителя, она завершается быстро даже при использовании ленточных устройств большой емкости.

Безопасность

Операция резервного копирования может указывать пароль для набора носителей. Если для набора носителей установлен пароль, то в инструкции RESTORE необходимо указать правильный пароль. Пароль предотвращает несанкционированные операции восстановления и присоединения резервных наборов данных к носителю при помощи инструментов Microsoft SQL Server. Однако пароль не запрещает перезапись носителей с помощью параметра FORMAT инструкции BACKUP.

Внимание

Данный пароль не обеспечивает надежную защиту. Он предназначен для предотвращения неверного восстановления при использовании средств 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)