RESTORE LABELONLY (Transact-SQL)

Статья
03/07/2014

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

Примечание

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

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии).

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

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

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

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

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

Разрешения

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