Инструкция RESTORE FILELISTONLY (Transact-SQL)
Возвращает результирующий набор со списком файлов журнала и базы данных, содержащихся в резервном наборе данных.
.gif "Примечание") Примечание |
|---|
Описания аргументов см. в разделе Аргументы инструкции RESTORE (Transact-SQL). |
.gif "Значок ссылки на раздел")
Синтаксис
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.
.gif "Примечание по безопасности") Примечание по безопасности |
|---|
Данный пароль не обеспечивает надежную защиту. Он предназначен для предотвращения неверного восстановления при использовании средств SQL Server авторизованными или неавторизованными пользователями. При этом остается возможным чтение данных резервных копий с помощью других средств или замена пароля. В будущей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется. Рекомендуемым способом защиты резервных копий является хранение лент с резервными копиями в безопасном месте или создание резервных копий на диске в виде файлов, защищенных соответствующими списками управления доступом (ACL). Списки ACL должны располагаться в корневом каталоге, в котором создаются резервные копии. |
Примеры
В следующем примере возвращаются данные из устройства резервного копирования с именем AdventureWorks2008R2Backups. В примере используется параметр FILE для указания второго резервного набора данных на устройстве.
RESTORE FILELISTONLY FROM AdventureWorks2008R2Backups
WITH FILE=2;
GO
См. также