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

  • Статья

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

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

DropLSN

numeric(25,0) NULL

Номер LSN, в котором произошло удаление файла. Если файл не удален, это значение равно NULL.

UniqueID

uniqueidentifier

Глобально уникальный идентификатор файла.

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 необходимо указывать верные пароли. Эти пароли предотвращают несанкционированные операции восстановления и присоединения резервных наборов данных к носителю при помощи инструментальных средств MicrosoftSQL Server. Однако пароль не препятствует перезаписи носителей с помощью параметра FORMAT инструкции BACKUP.

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

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

Примеры

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

RESTORE FILELISTONLY FROM AdventureWorksBackups 
   WITH FILE=2;
GO

Журнал изменений

Обновления

В таблицу «Результирующие наборы» добавлен столбец TDEThumbprint.