RESTORE 문 - FILELISTONLY(Transact-SQL)

적용 대상: SQL Server Azure SQL Managed Instance Azure Synapse Analytics 분석 플랫폼 시스템(PDW)

SQL Server에서 백업 세트에 포함된 로그 파일과 데이터베이스의 목록을 결과 집합으로 반환합니다.

참고

인수에 대한 자세한 설명은 RESTORE 인수(Transact-SQL)를 참조하세요.

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

참고

URL은 Microsoft Azure Blob Storage의 위치 및 파일 이름을 지정하는 데 사용되는 형식이며 SQL Server 2012(11.x) SP1 CU2부터 지원됩니다. Microsoft Azure Blob Storage는 서비스이지만, 모든 세 디바이스에 대해 일관되고 원활한 복원 환경을 가능하게 하는 디스크와 테이프와 구현이 유사합니다.

인수

RESTORE FILELISTONLY 인수에 대한 설명은 RESTORE 인수(Transact-SQL)를 참조하세요.

결과 집합

클라이언트는 RESTORE FILELISTONLY를 사용하여 백업 세트에 포함되어 있는 파일 목록을 가져올 수 있습니다. 이 정보는 각 파일에 대해 행 하나가 포함된 결과 집합으로 반환됩니다.

열 이름 데이터 형식 Description
LogicalName nvarchar(128) 파일의 논리적 이름입니다.
PhysicalName nvarchar(260) 물리적 파일 이름 또는 운영 체제 이름입니다.
Type char(1) 다음 중 하나에 해당하는 파일 유형입니다.

L = Microsoft SQL Server 로그 파일

D = SQL Server 데이터 파일

F = 전체 텍스트 카탈로그

S = FileStream, FileTable 또는 In-Memory OLTP 컨테이너
FileGroupName nvarchar(128) NULL 파일이 있는 파일 그룹의 이름입니다.
크기 numeric(20,0) 현재 크기(바이트)입니다.
MaxSize numeric(20,0) 허용되는 최대 크기(바이트)입니다.
FileID bigint 데이터베이스 내에서 고유한 파일 식별자입니다.
CreateLSN numeric(25,0) 파일이 생성된 시점의 로그 시퀀스 번호입니다.
DropLSN numeric(25,0) NULL 파일이 삭제된 시점의 로그 시퀀스 번호입니다. 파일이 아직 삭제되지 않은 경우 이 값은 NULL입니다.
UniqueID uniqueidentifier 파일의 GUID(Globally Unique Identifier)입니다.
ReadOnlyLSN numeric(25,0) NULL 해당 파일이 포함된 파일 그룹이 읽기/쓰기에서 읽기 전용으로 변경된 시점(가장 최근 변경)의 로그 시퀀스 번호입니다.
ReadWriteLSN numeric(25,0) NULL 해당 파일이 포함된 파일 그룹이 읽기 전용에서 읽기/쓰기로 변경된 시점(가장 최근의 변경)의 로그 시퀀스 번호입니다.
BackupSizeInBytes bigint 이 파일의 백업의 크기(바이트)입니다.
SourceBlockSize int 백업 디바이스를 제외한 해당 파일이 포함된 물리적 디바이스의 블록 크기(바이트)입니다.
FileGroupID int 파일 그룹의 ID입니다.
LogGroupGUID uniqueidentifier NULL NULL
DifferentialBaseLSN numeric(25,0) NULL 차등 백업의 경우 로그 시퀀스 번호가 DifferentialBaseLSN보다 크거나 같은 변경 내용이 포함됩니다.

다른 백업 유형의 경우 값은 NULL입니다.
DifferentialBaseGUID uniqueidentifier NULL 차등 백업의 경우 차등 기반의 고유 식별자입니다.

다른 백업 유형의 경우 값은 NULL입니다.
IsReadOnly bit 1 = 파일이 읽기 전용입니다.
IsPresent bit 1 = 파일이 백업에 있습니다.
TDEThumbprint varbinary(32) NULL 데이터베이스 암호화 키의 지문을 표시합니다. 암호기 지문은 키 암호화에 사용되는 인증서의 SHA-1 해시입니다. 데이터 암호화에 대한 자세한 내용은 투명한 데이터 암호화(TDE)를 참조하세요.
SnapshotURL nvarchar(360) NULL 적용 대상: SQL Server(SQL Server 2016(13.x) (CU1) ~ 현재 버전).

FILE_SNAPSHOT 백업에 포함된 데이터베이스 파일의 Azure 스냅샷에 대한 URL입니다. FILE_SNAPSHOT 백업이 없는 경우 NULL을 반환합니다.

보안

필요한 경우 백업 작업에서 미디어 세트, 백업 세트 또는 이 둘 모두에 대해 암호를 지정할 수 있습니다. 미디어 세트나 백업 세트에 암호가 정의되어 있는 경우 RESTORE 문에서 정확한 암호를 지정해야 합니다. 해당 암호를 지정하면 Microsoft SQL Server 도구를 사용하여 무단으로 복원 작업을 수행하거나 미디어에 백업 세트를 무단으로 추가하는 작업을 방지할 수 있습니다. 하지만 암호를 사용해도 BACKUP 문의 FORMAT 옵션을 사용하여 미디어를 덮어쓰는 작업은 수행됩니다.

중요

이 암호에 의한 보호 수준은 낮습니다. 권한 유무에 관계없이 사용자가 SQL Server 도구를 사용하여 잘못된 복원을 수행하는 것을 방지합니다. 다른 수단을 사용한 백업 데이터 읽기나 암호 바꾸기를 방지하지는 않습니다. Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 백업을 보호하는 최상의 방법은 백업 테이프를 안전한 장소에 보관하거나 적합한 ACL(액세스 제어 목록)로 보호되는 디스크 파일에 백업하는 것입니다. ACL은 백업이 만들어지는 디렉터리 루트에 설정해야 합니다.

사용 권한

SQL Server 2008부터는 백업 세트나 백업 디바이스에 대한 정보를 얻으려면 CREATE DATABASE 권한이 필요합니다. 자세한 내용은 GRANT 데이터베이스 사용 권한(Transact-SQL)을 참조하세요.

예제

다음 예에서는 AdventureWorksBackups라는 백업 디바이스에서 정보를 반환합니다. 이 예에서는 FILE 옵션을 사용하여 디바이스에 두 번째 백업 세트를 지정합니다.

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO  

참고 항목

BACKUP(Transact-SQL)
미디어 세트, 미디어 패밀리 및 백업 세트(SQL Server)
RESTORE REWINDONLY(Transact-SQL)
RESTORE VERIFYONLY(Transact-SQL)
RESTORE(Transact-SQL)
백업 기록 및 헤더 정보(SQL Server)