RESTORE FILELISTONLY (Transact-SQL)
Возвращает результирующий набор со списком файлов журнала и базы данных, содержащихся в резервном наборе данных.
Примечание. |
---|
Описания аргументов см. в разделе Аргументы инструкции RESTORE (Transact-SQL). |
Соглашения о синтаксисе в Transact-SQL
Синтаксис
RESTORE FILELISTONLY
FROM <backup_device>
[ WITH
[ { CHECKSUM | NO_CHECKSUM } ]
[ [ , ] { CONTINUE_AFTER_ERROR | STOP_ON_ERROR } ]
[ [ , ] FILE = backup_set_file_number ]
[ [ , ] MEDIANAME = { media_name | @media_name_variable } ]
[ [ , ] MEDIAPASSWORD = { mediapassword |
@mediapassword_variable } ]
[ [ , ] PASSWORD = { password | @password_variable } ]
[ [ , ] REWIND ]
[ [ , ] { UNLOAD | NOUNLOAD } ]
]
[;]
<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 |
Глобально уникальный идентификатор файла. |
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 = Файл присутствует в резервной копии. |
Разрешения
Любой пользователь может использовать RESTORE FILELISTONLY.
В операции создания резервной копии могут дополнительно задаваться пароли для набора носителей или набора резервных копий либо и для того, и для другого. Если для набора носителей или резервных наборов данных установлен пароль, то в инструкции RESTORE необходимо указывать корректный пароль или пароли. Эти пароли предотвращают несанкционированные операции восстановления и добавления резервных наборов данных к носителю с помощью средств Microsoft SQL Server 2005. Тем не менее, пароль не запрещает перезапись носителей с помощью параметра FORMAT инструкции BACKUP.
Примечание безопасности. |
---|
Данный пароль не обеспечивает надежную защиту. Он предназначается для предотвращения некорректного восстановления с использованием средств SQL Server 2005 авторизованными или неавторизованными пользователями. Он не запрещает чтение резервных данных другим способом или заменой пароля. Оптимальным способом защиты резервных копий является хранение архивных лент в безопасном месте или резервное копирование на диск файлов, защищенных надлежащими списками управления доступом (списки ACL). Списки ACL необходимо задавать в корневом каталоге, в рамках которого созданы резервные копии. |
Примеры
Следующий пример возвращает данные из устройства резервного копирования под названием AdventureWorksBackups. Пример использует параметр FILE для указания второго резервного набора данных на устройстве.
RESTORE FILELISTONLY FROM AdventureWorksBackups
WITH FILE=2;
GO
См. также
Справочник
BACKUP (Transact-SQL)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Другие ресурсы
Наборы носителей, семейства носителей и резервные наборы данных
Просмотр сведений о резервных копиях
Основные понятия о регистрационных номерах транзакций в журнале