Поделиться через


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 необходимо указать правильный пароль. Пароль предотвращает несанкционированные операции восстановления и присоединения резервных наборов данных к носителю при помощи инструментальных средств MicrosoftSQL Server. Однако пароль не препятствует перезаписи носителей с помощью параметра FORMAT инструкции BACKUP.

Примечание по безопасностиПримечание по безопасности

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