RESTORE FILELISTONLY(Transact-SQL)
백업 세트에 포함된 데이터베이스와 로그 파일의 목록을 포함하는 결과 집합을 반환합니다.
[!참고]
인수에 대한 설명은 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를 사용하여 백업 세트에 포함되어 있는 파일 목록을 가져올 수 있습니다. 이 정보는 각 파일에 대해 행 하나가 포함된 결과 집합으로 반환됩니다.
열 이름 |
데이터 형식 |
설명 |
LogicalName |
nvarchar(128) |
파일의 논리적 이름입니다. |
PhysicalName |
nvarchar(260) |
물리적 파일 이름 또는 운영 체제 이름입니다. |
Type |
char(1) |
다음 중 하나에 해당하는 파일 유형입니다. L = Microsoft SQL Server 로그 파일 D = SQL Server 데이터 파일 F = 전체 텍스트 카탈로그 |
FileGroupName |
nvarchar(128) |
파일이 있는 파일 그룹의 이름입니다. |
Size |
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입니다. LSN(로그 시퀀스 번호)에 대한 자세한 내용은 로그 시퀀스 번호 소개를 참조하십시오. |
DifferentialBaseGUID |
uniqueidentifier |
차등 백업의 경우 차등 기반의 고유 식별자입니다. 다른 백업 유형의 경우 값은 NULL입니다. |
IsReadOnly |
bit |
1 = 파일이 읽기 전용입니다. |
IsPresent |
bit |
1 = 파일이 백업 세트에 있습니다. |
TDEThumbprint |
varbinary(32) |
데이터베이스 암호화 키의 지문을 표시합니다. 암호기 지문은 키 암호화에 사용되는 인증서의 SHA-1 해시입니다. 데이터베이스 암호화에 대한 자세한 내용은 TDE(Transparent Data Encryption) 이해를 참조하십시오. |
사용 권한
SQL Server 2008 이상 버전에서 백업 세트나 백업 장치에 대한 정보를 얻으려면 CREATE DATABASE 권한이 필요합니다. 자세한 내용은 GRANT 데이터베이스 사용 권한(Transact-SQL)을 참조하십시오.
백업 작업은 미디어 세트, 백업 세트 또는 이 둘 모두에 대해 암호를 지정할 수 있습니다. 미디어 세트나 백업 세트에 암호가 정의되어 있는 경우 RESTORE 문에서 정확한 암호를 지정해야 합니다. 이러한 암호를 지정하면 Microsoft SQL Server 도구를 사용하여 무단으로 복원 작업을 수행하거나 미디어에 백업 세트를 무단으로 추가하는 작업을 방지할 수 있습니다. 하지만 암호를 사용해도 BACKUP 문의 FORMAT 옵션을 사용하여 미디어를 덮어쓰는 작업은 수행됩니다.
.gif "보안 정보") 보안 정보 |
|---|
이 암호에 의한 보호 수준은 낮습니다. 권한 유무에 관계없이 사용자가 SQL Server 도구를 사용하여 잘못된 복원을 수행하는 것을 방지합니다. 다른 수단을 사용한 백업 데이터 읽기나 암호 바꾸기를 방지하지는 않습니다. Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오. 백업을 보호하는 최상의 방법은 백업 테이프를 안전한 장소에 보관하거나 적합한 ACL(액세스 제어 목록)로 보호되는 디스크 파일에 백업하는 것입니다. ACL은 백업이 만들어지는 디렉터리 루트에 설정해야 합니다. |
예
다음 예에서는 AdventureWorks2008R2Backups라는 백업 장치에서 정보를 반환합니다. 이 예에서는 FILE 옵션을 사용하여 장치에 두 번째 백업 세트를 지정합니다.
RESTORE FILELISTONLY FROM AdventureWorks2008R2Backups
WITH FILE=2;
GO