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

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

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

RESTORE HEADERONLY
FROM <backup_device>
[ WITH
    {
    -- Backup set options
    FILE = { backup_set_file_number | @backup_set_file_number }
    | PASSWORD = { password | @password_variable }
    | [ METADATA_ONLY | SNAPSHOT ] [ DBNAME = { database_name | @database_name_variable } ]

    -- 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 }
}

Аргументы

Описание RESTORE HEADERONLY аргументов см. в разделе RESTORE Arguments (Transact-SQL).

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

Сервер отправляет строку данных заголовка со следующими столбцами для каждой резервной копии на данном устройстве:

¹ Если пароли определены для резервных наборов данных, RESTORE HEADERONLY отображаются полные сведения только для резервного набора, пароль которого соответствует указанному PASSWORD параметру команды. RESTORE HEADERONLY также отображаются полные сведения для незащищенных резервных наборов данных. Столбец BackupName для других защищенных паролем резервных наборов резервных копий на носителе имеет 'Password Protected'значение NULL, а все остальные столбцы — NULL.

Замечания

Клиент может использовать RESTORE HEADERONLY для получения всех сведений о заголовке резервных копий для всех резервных копий на определенном устройстве резервного копирования. Для каждой резервной копии на устройстве резервного копирования сервер передает данные заголовка в виде строки.

RESTORE HEADERONLY просматривает все резервные наборы на носителе. Поэтому для получения этого результирующего набора из ленточных накопителей большой емкости может потребоваться некоторое время. Чтобы быстро просмотреть носитель, не получая сведения о каждом наборе резервных копий, используйте RESTORE LABELONLY или укажите FILE = <backup_set_file_number>.

Благодаря характеру формата ленты Microsoft можно использовать резервные наборы из других программ, чтобы занять место на том же носителе, что и резервные наборы резервных копий SQL Server. Результирующий набор, возвращаемый путем RESTORE HEADERONLY , включает строку для каждого из этих других резервных наборов.

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

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

Разрешения

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

Примеры

В следующем примере возвращаются данные из заголовка файла на диске C:\AdventureWorks-FullBackup.bak.

RESTORE HEADERONLY
FROM DISK = N'C:\AdventureWorks-FullBackup.bak';
GO

См. также

• BACKUP (Transact-SQL)
• backupset (Transact-SQL)
• RESTORE REWINDONLY (Transact-SQL)
• RESTORE VERIFYONLY (Transact-SQL).
• RESTORE (Transact-SQL)
• Журнал резервных копий и сведения о заголовке резервной копии (SQL Server)
• Включение или отключение вычисления контрольных сумм резервных копий во время архивации или восстановления (SQL Server)
• Наборы носителей, семейства носителей и резервные наборы данных (SQL Server)
• Модели восстановления (SQL Server)