RESTORE Statements - LABELONLY(Transact-SQL)

아티클
05/30/2023

적용 대상:SQL Server Azure SQL Managed Instance

특정 백업 디바이스로 식별하는 백업 미디어에 대한 정보가 포함된 결과 집합을 반환합니다.

참고

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

Syntax

  
RESTORE LABELONLY   
FROM <backup_device>   
[ WITH   
 {  
--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 LABELONLY 인수에 대한 설명은 RESTORE 인수(Transact-SQL)를 참조하세요.

결과 집합

RESTORE LABELONLY의 결과 집합은 다음 정보를 가진 단일 행으로 구성됩니다.

열 이름	데이터 형식	Description
MediaName	nvarchar(128)	미디어의 이름입니다.
MediaSetId	uniqueidentifier	미디어 세트의 고유 ID입니다.
FamilyCount	int	미디어 세트에서 미디어 패밀리의 번호입니다.
FamilySequenceNumber	int	해당 패밀리의 시퀀스 번호입니다.
MediaFamilyId	uniqueidentifier	미디어 패밀리의 고유 ID입니다.
MediaSequenceNumber	int	미디어 패밀리에 있는 해당 미디어의 시퀀스 번호입니다.
MediaLabelPresent	tinyint	미디어 설명에 다음이 포함되는지 여부입니다. 1 = Microsoft Tape Format 미디어 레이블 0 = 미디어 설명
MediaDescription	nvarchar(255)	자유 형식 텍스트로 된 미디어 설명 또는 Tape Format 미디어 레이블입니다.
SoftwareName	nvarchar(128)	미디어 레이블을 기록하는 백업 소프트웨어의 이름입니다.
SoftwareVendorId	int	백업을 기록하는 소프트웨어 공급업체의 고유 공급업체 ID입니다.
MediaDate	datetime	레이블을 작성한 날짜와 시간입니다.
Mirror_Count	int	세트에 있는 미러 수(1-4)입니다. 참고: 한 세트에 있는 다른 미러에 대해 기록된 레이블은 모두 동일합니다.
IsCompressed	bit	백업의 압축 여부: 0 = 압축되지 않음 1 = 압축됨

참고

미디어 세트에 대한 암호를 정의한 경우 RESTORE LABELONLY는 올바른 미디어 암호를 명령의 MEDIAPASSWORD 옵션에 지정한 경우에만 정보를 반환합니다.

일반적인 주의 사항

백업 미디어의 내용을 빨리 찾을 수 있는 방법은 RESTORE LABELONLY를 실행하는 것입니다. RESTORE LABELONLY에서는 미디어 헤더만 읽기 때문에 고성능의 테이프 디바이스를 사용하는 경우에도 이 문은 빨리 완료됩니다.

보안

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

중요

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

사용 권한

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

참고 항목

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