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

ОБЛАСТЬ ПРИМЕНЕНИЯ: ДаSQL Server ДаУправляемый экземпляр SQL Azure НетAzure Synapse Analytics (Хранилище данных SQL) НетParallel Data Warehouse APPLIES TO: YesSQL Server YesAzure SQL Managed Instance NoAzure Synapse Analytics (SQL DW) NoParallel Data Warehouse

Возвращает результирующий набор со списком файлов журнала и базы данных, содержащихся в резервном наборе данных в SQL ServerSQL Server.Returns a result set containing a list of the database and log files contained in the backup set in SQL ServerSQL Server.

Примечание

Описания аргументов см. в разделе Аргументы инструкции RESTORE (Transact-SQL).For the descriptions of the arguments, see RESTORE Arguments (Transact-SQL).

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

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 | URL } = { 'physical_backup_device_name' |  
       @physical_backup_device_name_var }   
}  

Примечание

URL-адрес — это формат, который используется для указания расположения и имени файла для хранилища BLOB-объектов Microsoft Azure и поддерживается начиная с SQL Server 2012 (11.x)SQL Server 2012 (11.x) SP1 CU2.URL is the format used to specify the location and the file name for Microsoft Azure Blob Storage and is supported starting with SQL Server 2012 (11.x)SQL Server 2012 (11.x) SP1 CU2. Хотя хранилище Microsoft Azure является службой, реализация аналогична дисковому и ленточному хранилищу, чтобы обеспечить единообразное и эффективное восстановление для всех трех устройств.Although Microsoft Azure storage is a service, the implementation is similar to disk and tape to allow for a consistent and seamless restore experience for all the three devices.

АргументыArguments

Описание аргументов инструкции RESTORE FILELISTONLY см. в разделе Аргументы инструкции RESTORE (Transact-SQL).For descriptions of the RESTORE FILELISTONLY arguments, see RESTORE Arguments (Transact-SQL).

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

Клиент может использовать RESTORE FILELISTONLY для получения списка файлов, содержащихся в резервном наборе данных.A client can use RESTORE FILELISTONLY to obtain a list of the files contained in a backup set. Эти данные возвращаются как результирующий набор, содержащий одну строку для каждого файла.This information is returned as a result set containing one row for each file.

Имя столбцаColumn name Тип данныхData type ОписаниеDescription
ЛогическоеИмяLogicalName nvarchar(128)nvarchar(128) Логическое имя файла.Logical name of the file.
PhysicalNamePhysicalName nvarchar(260)nvarchar(260) Физическое имя или имя файла в операционной системе.Physical or operating-system name of the file.
ТипType char(1)char(1) Тип файла:The type of file, one of:

L = файл журнала Microsoft SQL ServerSQL ServerL = Microsoft SQL ServerSQL Server log file

D = SQL ServerSQL Server файл данныхD = SQL ServerSQL Server data file

F = полнотекстовый каталогF = Full Text Catalog

S = файловый поток, FileTable или контейнер Выполняющаяся в памяти OLTPIn-Memory OLTPS = FileStream, FileTable, or Выполняющаяся в памяти OLTPIn-Memory OLTP container
FileGroupNameFileGroupName nvarchar(128) NULLnvarchar(128) NULL Имя файловой группы, в которую входит файл.Name of the filegroup that contains the file.
РазмерSize numeric(20,0)numeric(20,0) Текущий размер в байтах.Current size in bytes.
MaxSizeMaxSize numeric(20,0)numeric(20,0) Максимальный разрешенный размер в байтах.Maximum allowed size in bytes.
FileIDFileID bigintbigint Идентификатор файла, уникальный в пределах базы данных.File identifier, unique within the database.
CreateLSNCreateLSN numeric(25,0)numeric(25,0) Регистрационный номер в журнале, под которым был создан файл.Log sequence number at which the file was created.
DropLSNDropLSN numeric(25,0) NULLnumeric(25,0) NULL Номер LSN, в котором произошло удаление файла.The log sequence number at which the file was dropped. Если файл не удален, установлено значение NULL.If the file has not been dropped, this value is NULL.
UniqueIDUniqueID uniqueidentifieruniqueidentifier Идентификатор GUID файла.Globally unique identifier of the file.
ReadOnlyLSNReadOnlyLSN numeric(25,0) NULLnumeric(25,0) NULL Регистрационный номер в журнале, под которым файловая группа, содержащая файл, изменила тип доступа с «для чтения и записи» на «только для чтения» (самое последнее изменение).Log sequence number at which the filegroup containing the file changed from read-write to read-only (the most recent change).
ReadWriteLSNReadWriteLSN numeric(25,0) NULLnumeric(25,0) NULL Регистрационный номер транзакции в журнале, под которым файловая группа, содержащая файл, изменила тип с «только для чтения» на «для чтения и записи» (самое последнее изменение).Log sequence number at which the filegroup containing the file changed from read-only to read-write (the most recent change).
BackupSizeInBytesBackupSizeInBytes bigintbigint Размер резервной копии этого файла в байтах.Size of the backup for this file in bytes.
SourceBlockSizeSourceBlockSize intint Размер блока физического устройства, содержащего файл, в байтах (не устройства резервного копирования).Block size of the physical device containing the file in bytes (not the backup device).
FileGroupIDFileGroupID intint Идентификатор файловой группы.ID of the filegroup.
LogGroupGUIDLogGroupGUID uniqueidentifier NULLuniqueidentifier NULL NULL.NULL.
DifferentialBaseLSNDifferentialBaseLSN numeric(25,0) NULLnumeric(25,0) NULL Для разностных резервных копий изменения номеров LSN, которые превышают или равны DifferentialBaseLSN, включаются в разность.For differential backups, changes with log sequence numbers greater than or equal to DifferentialBaseLSN are included in the differential.

Для других типов резервных копий установлено значение NULL.For other backup types, the value is NULL.
DifferentialBaseGUIDDifferentialBaseGUID uniqueidentifier NULLuniqueidentifier NULL Для разностных резервных копий — уникальный идентификатор базовой копии для разностного копирования.For differential backups, the unique identifier of the differential base.

Для других типов резервных копий установлено значение NULL.For other backup types, the value is NULL.
IsReadOnlyIsReadOnly bitbit 1 = Файл доступен только для чтения.1 = The file is read-only.
IsPresentIsPresent bitbit 1 = Файл присутствует в резервной копии.1 = The file is present in the backup.
TDEThumbprintTDEThumbprint varbinary(32) NULLvarbinary(32) NULL Показывает отпечаток ключа шифрования базы данных.Shows the thumbprint of the Database Encryption Key. Отпечатком шифратора является хэш SHA-1 сертификата, с которым шифруется ключ.The encryptor thumbprint is a SHA-1 hash of the certificate with which the key is encrypted. Дополнительные сведения о шифровании баз данных см. в статье Прозрачное шифрование данных (TDE).For information about database encryption, see Transparent Data Encryption (TDE).
SnapshotURLSnapshotURL nvarchar(360) NULLnvarchar(360) NULL URL-адрес моментального снимка Azure файла базы данных, содержащегося в резервной копии FILE_SNAPSHOT.The URL for the Azure snapshot of the database file contained in the FILE_SNAPSHOT backup. Возвращает значение NULL, если резервная копия FILE_SNAPSHOT отсутствует.Returns NULL if no FILE_SNAPSHOT backup.

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

В операции создания резервной копии могут дополнительно указываться пароли для набора носителей, резервного набора данных или и того и другого.A backup operation may optionally specify passwords for a media set, a backup set, or both. Если для набора носителей или резервного набора данных установлен пароль, то в инструкции RESTORE необходимо указывать правильные пароли.When a password has been defined on a media set or backup set, you must specify the correct password or passwords in the RESTORE statement. Эти пароли предотвращают несанкционированные операции восстановления и присоединения резервных наборов данных к носителю при помощи инструментов MicrosoftMicrosoft SQL ServerSQL Server.These passwords prevent unauthorized restore operations and unauthorized appends of backup sets to media using MicrosoftMicrosoft SQL ServerSQL Server tools. Однако пароль не запрещает перезапись носителей с помощью параметра FORMAT инструкции BACKUP.However, a password does not prevent overwrite of media using the BACKUP statement's FORMAT option.

Важно!

Данный пароль не обеспечивает надежную защиту.The protection provided by this password is weak. Он предназначен для предотвращения неверного восстановления при использовании средств SQL ServerSQL Server авторизованными или неавторизованными пользователями.It is intended to prevent an incorrect restore using SQL ServerSQL Server tools by authorized or unauthorized users. При этом остается возможным чтение данных резервных копий с помощью других средств или замена пароля.It does not prevent the reading of the backup data by other means or the replacement of the password. В будущей версии Microsoft SQL Server этот компонент будет удален.This feature will be removed in a future version of Microsoft SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Рекомендуемым способом защиты резервных копий является хранение лент с резервными копиями в безопасном месте или создание резервных копий на диске в виде файлов, защищенных соответствующими списками управления доступом (ACL).The best practice for protecting backups is to store backup tapes in a secure location or back up to disk files that are protected by adequate access control lists (ACLs). Списки ACL должны располагаться в корневом каталоге, в котором создаются резервные копии.The ACLs should be set on the directory root under which backups are created.

РазрешенияPermissions

В SQL Server 2008SQL Server 2008 и более поздних версиях, чтобы получить сведения о резервном наборе данных или устройстве резервного копирования, необходимо разрешение CREATE DATABASE.Beginning in SQL Server 2008SQL Server 2008, obtaining information about a backup set or backup device requires CREATE DATABASE permission. Дополнительные сведения см. в разделе GRANT, предоставление разрешений для базы данных (Transact-SQL).For more information, see GRANT Database Permissions (Transact-SQL).

ПримерыExamples

В следующем примере возвращаются данные из устройства резервного копирования с именем AdventureWorksBackups.The following example returns the information from a backup device named AdventureWorksBackups. В примере используется параметр FILE для указания второго резервного набора данных на устройстве.The example uses the FILE option to specify the second backup set on the device.

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO  

См. также:See Also

BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Наборы носителей, семейства носителей и резервные наборы данных (SQL Server) Media Sets, Media Families, and Backup Sets (SQL Server)
RESTORE REWINDONLY (Transact-SQL) RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL) RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL) RESTORE (Transact-SQL)
Журнал и сведения о заголовке резервной копии (SQL Server)Backup History and Header Information (SQL Server)