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


Инструкция 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)

Имя файловой группы, в которую входит файл.

Размер

numeric(20,0)

Текущий размер в байтах.

MaxSize

numeric(20,0)

Максимальный разрешенный размер в байтах.

FileID

bigint

Идентификатор файла, уникальный в пределах базы данных.

CreateLSN

numeric(25,0)

Номер LSN, в котором был создан файл.

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.

Сведения о порядковых номерах LSN см. во введении к разделу Основные понятия о регистрационных номерах транзакций в журнале.

DifferentialBaseGUID

uniqueidentifier

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

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

IsReadOnly

bit

1 = Файл доступен только для чтения.

IsPresent

bit

1 = Файл присутствует в резервной копии.

TDEThumbprint

varbinary(32)

Показывает отпечаток ключа шифрования базы данных. Отпечатком шифратора является хэш SHA-1 сертификата, с которым шифруется ключ. Дополнительные сведения о шифровании базы данных см. в разделе Основные сведения о прозрачном шифровании данных (TDE).

Разрешения

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

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

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

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

Примеры

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

RESTORE FILELISTONLY FROM AdventureWorks2008R2Backups 
   WITH FILE=2;
GO