Статья
04/01/2012

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)	Описание носителя в произвольной текстовой форме или метка носителя 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 считывает только заголовок носителя, она завершается быстро даже при использовании ленточных устройств большой емкости.

Разрешения

В SQL Server 2008 и более поздних версиях для получения сведений о резервном наборе данных или устройстве резервного копирования необходимо разрешение CREATE DATABASE. Дополнительные сведения см. в разделе GRANT, предоставление разрешений на базу данных (Transact-SQL).

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

Примечание по безопасности
Данный пароль не обеспечивает надежную защиту. Он предназначен для предотвращения неверного восстановления при использовании средств SQL Server авторизованными или неавторизованными пользователями. При этом остается возможным чтение данных резервной копии с использованием других средств или с помощью смены пароля. В будущей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется. Оптимальным способом защиты резервных копий является хранение лент с резервными копиями в безопасном месте или создание резервных копий на диске в виде файлов, защищенных соответствующими списками управления доступом (ACL). ACL необходимо задавать в корневом каталоге, внутри которого создаются резервные копии.

Данный пароль не обеспечивает надежную защиту. Он предназначен для предотвращения неверного восстановления при использовании средств SQL Server авторизованными или неавторизованными пользователями. При этом остается возможным чтение данных резервной копии с использованием других средств или с помощью смены пароля. В будущей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется. Оптимальным способом защиты резервных копий является хранение лент с резервными копиями в безопасном месте или создание резервных копий на диске в виде файлов, защищенных соответствующими списками управления доступом (ACL). ACL необходимо задавать в корневом каталоге, внутри которого создаются резервные копии.