RESTORE Утверждения - FILELISTONLY (Transact-SQL)

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

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

Примечание.

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

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

Синтаксис

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

Примечание.

URL-адрес — это формат, который используется для указания расположения и имени файла для хранилища BLOB-объектов Microsoft Azure и поддерживается начиная с SQL Server 2012 (11.x) SP1 CU2. Хотя хранилище Microsoft Azure является службой, реализация аналогична дисковому и ленточному хранилищу, чтобы обеспечить единообразное и эффективное восстановление для всех трех устройств.

Аргументы

Для описания RESTORE FILELISTONLY аргументов см. RESTORE Аргументы (Transact-SQL).

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

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

Имя столбца Тип данных Description
LogicalName nvarchar(128) Логическое имя файла.
PhysicalName nvarchar(260) Физическое имя или имя файла в операционной системе.
Тип char(1) Тип файла:

L = файл журнала Microsoft SQL Server

D = файл данных SQL Server

F = полнотекстовый каталог

S = файловый поток, FileTable или контейнер выполняющейся в памяти OLTP
FileGroupName Нварчар (128) NULL Имя файловой группы, в которую входит файл.
Размер numeric(20,0) Текущий размер в байтах.
MaxSize numeric(20,0) Максимальный разрешенный размер в байтах.
FileID bigint Идентификатор файла, уникальный в пределах базы данных.
CreateLSN numeric(25,0) Регистрационный номер в журнале, под которым был создан файл.
DropLSN числовые (25,0) NULL Номер LSN, в котором произошло удаление файла. Если файл не удален, установлено значение NULL.
UniqueID uniqueidentifier Идентификатор GUID файла.
ReadOnlyLSN numeric(25,0) NULL Регистрационный номер в журнале, под которым файловая группа, содержащая файл, изменила тип доступа с «для чтения и записи» на «только для чтения» (самое последнее изменение).
ReadWriteLSN числовые (25,0) NULL Регистрационный номер транзакции в журнале, под которым файловая группа, содержащая файл, изменила тип с «только для чтения» на «для чтения и записи» (самое последнее изменение).
BackupSizeInBytes bigint Размер резервной копии этого файла в байтах.
SourceBlockSize int Размер блока физического устройства, содержащего файл, в байтах (не устройства резервного копирования).
FileGroupID int Идентификатор файловой группы.
LogGroupGUID уникальный идентификатор NULL NULL.
DifferentialBaseLSN числовые (25,0) NULL Для разностных резервных копий изменения номеров LSN, которые превышают или равны DifferentialBaseLSN, включаются в разность.

Для других типов резервных копий установлено значение NULL.
DifferentialBaseGUID уникальный идентификатор NULL Для разностных резервных копий — уникальный идентификатор базовой копии для разностного копирования.

Для других типов резервных копий установлено значение NULL.
IsReadOnly bit 1 = Файл доступен только для чтения.
IsPresent bit 1 = Файл присутствует в резервной копии.
TDEThumbprint варбинарный (32) NULL Показывает отпечаток ключа шифрования базы данных. Отпечатком шифратора является хэш SHA-1 сертификата, с которым шифруется ключ. Дополнительные сведения о шифровании баз данных см. в статье Прозрачное шифрование данных (TDE).
SnapshotURL Нварчар (360) NULL Область применения: SQL Server (с SQL Server 2016 (13.x) (с накопительным пакетом обновления 1) до текущей версии.

URL-адрес моментального снимка Azure файла базы данных, содержащегося в резервной копии FILE_SNAPSHOT. Возвращает значение NULL, если резервная копия FILE_SNAPSHOT отсутствует.

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

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

Внимание

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

Разрешения

Начиная с SQL Server 2008 (10.0.x), получение информации о резервном наборе или резервном устройстве требует CREATE DATABASE разрешения. Дополнительные сведения см. в разделе GRANT "Разрешения базы данных" (Transact-SQL).

Примеры

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

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO

Связанные материалы

  • Last updated on