Инструкция RESTORE FILELISTONLY (Transact-SQL)

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

Примечание
Описания аргументов см. в разделе Аргументы инструкции 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 } 

--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 FILELISTONLY см. в разделе Аргументы инструкции RESTORE (Transact-SQL).

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

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

Имя столбца	Тип данных	Описание
LogicalName	nvarchar(128)	Логическое имя файла.
PhysicalName	nvarchar(260)	Физическое имя или имя файла в операционной системе.
Type	char(1)	Тип файла: L = файл журнала Microsoft SQL Server D = файл данных SQL Server F = полнотекстовый каталог
FileGroupName	nvarchar(128)	Имя файловой группы, в которую входит файл.
Size	numeric(20,0)	Текущий размер в байтах.
MaxSize	numeric(20,0)	Максимальный разрешенный размер в байтах.
FileID	bigint	Идентификатор файла, уникальный в пределах базы данных.
CreateLSN	numeric(25,0)	Регистрационный номер в журнале, под которым был создан файл.
DropLSN	numeric(25,0) NULL	Номер LSN, в котором произошло удаление файла. Если файл не удален, установлено значение NULL.
UniqueID	uniqueidentifier	Идентификатор GUID файла.
ReadOnlyLSN	numeric(25,0) NULL	Регистрационный номер в журнале, под которым файловая группа, содержащая файл, изменила тип доступа с «для чтения и записи» на «только для чтения» (самое последнее изменение).
ReadWriteLSN	numeric(25,0) NULL	Регистрационный номер транзакции в журнале, под которым файловая группа, содержащая файл, изменила тип с «только для чтения» на «для чтения и записи» (самое последнее изменение).
BackupSizeInBytes	bigint	Размер резервной копии этого файла в байтах.
SourceBlockSize	int	Размер блока физического устройства, содержащего файл, в байтах (не устройства резервного копирования).
FileGroupID	int	Идентификатор файловой группы.
LogGroupGUID	uniqueidentifier NULL	NULL.
DifferentialBaseLSN	numeric(25,0) NULL	Для разностных резервных копий изменения номера LSN, большие или равные DifferentialBaseLSN, включаются в разность. Для других типов резервных копий применяется значение NULL.
DifferentialBaseGUID	uniqueidentifier	Для разностных резервных копий — уникальный идентификатор базовой копии для разностного копирования. Для других типов резервных копий — значение NULL.
IsReadOnly	bit	1 = Файл доступен только для чтения.
IsPresent	bit	1 = Файл присутствует в резервной копии.
TDEThumbprint	varbinary(32)	Показывает отпечаток ключа шифрования базы данных. Отпечатком шифратора является хэш SHA-1 сертификата, с которым шифруется ключ. Дополнительные сведения о шифровании базы данных см. в разделе Прозрачное шифрование данных (TDE).

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

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

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

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

Разрешения

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

Примеры

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

RESTORE FILELISTONLY FROM AdventureWorksBackups 
   WITH FILE=2;
GO

См. также

Справочник

BACKUP (Transact-SQL)

RESTORE REWINDONLY (Transact-SQL)

RESTORE VERIFYONLY (Transact-SQL)

RESTORE (Transact-SQL)

Основные понятия

Наборы носителей, семейства носителей и резервные наборы данных (SQL Server)

Журнал и сведения о заголовке резервной копии (SQL Server)