RESTORE 문-FILELISTONLY (Transact SQL)RESTORE Statements - FILELISTONLY (Transact-SQL)

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse 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-SQL 구문 규칙Topic 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 } = { 'physical_backup_device_name' |  
       @physical_backup_device_name_var }   
}  

인수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 DescriptionDescription
LogicalNameLogicalName 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 Server 로그 파일L = Microsoft SQL ServerSQL Server log file

D = SQL ServerSQL Server 데이터 파일D = SQL ServerSQL Server data file

F = 전체 텍스트 카탈로그F = Full Text Catalog

S = FileStream, FileTable 또는 메모리 내 OLTPIn-Memory OLTP 컨테이너S = FileStream, FileTable, or 메모리 내 OLTPIn-Memory OLTP container
FileGroupNameFileGroupName nvarchar (128)nvarchar(128) 파일이 있는 파일 그룹의 이름입니다.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 파일이 삭제된 시점의 로그 시퀀스 번호입니다.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)입니다.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입니다.ID of the filegroup.
LogGroupGUIDLogGroupGUID uniqueidentifier NULLuniqueidentifier NULL NULLNULL.
DifferentialBaseLSNDifferentialBaseLSN numeric(25,0) NULLnumeric(25,0) NULL 차등 백업에 대 한 로그 시퀀스 번호 보다 크거나 변경 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 uniqueidentifieruniqueidentifier 차등 백업의 경우 차등 기반의 고유 식별자입니다.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)varbinary(32) 데이터베이스 암호화 키의 지문을 표시합니다.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)nvarchar(360) FILE_SNAPSHOT 백업에 포함 된 데이터베이스 파일의 Azure 스냅샷에 대 한 URL입니다.The URL for the Azure snapshot of the database file contained in the FILE_SNAPSHOT backup. FILE_SNAPSHOT 백업이 없는 경우 NULL을 반환 합니다.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. 하지만 암호를 사용해도 BACKUP 문의 FORMAT 옵션을 사용하여 미디어를 덮어쓰는 작업은 수행됩니다.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.

PermissionsPermissions

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)