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 состоит из одной строки с этой информацией.

Имя столбца	Тип данных	Описание
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	бит	Указывает, является ли резервная копия сжатой: 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)