sp_addumpdevice(Transact-SQL)

적용 대상: SQL Server(지원되는 모든 버전)

적용 대상: SQL Server (SQL Server 2008 ~ 현재 버전).

백업 디바이스를 SQL Server 인스턴스에 추가합니다.

Topic link iconTransact-SQL 구문 규칙

구문

  
sp_addumpdevice [ @devtype = ] 'device_type'   
    , [ @logicalname = ] 'logical_name'   
    , [ @physicalname = ] 'physical_name'  
      [ , { [ @cntrltype = ] controller_type |  
          [ @devstatus = ] 'device_status' }  
      ]  

인수

[ @devtype = ] 'device_type' 백업 디바이스의 유형입니다. device_type 기본값이 없는 varchar(20)이며 다음 값 중 하나일 수 있습니다.

Description
디스크 백업 디바이스로서의 하드 디스크 파일입니다.
테이프 Microsoft Windows에서 지원하는 모든 테이프 디바이스입니다.

참고: 테이프 백업 디바이스에 대한 지원은 이후 버전의 SQL Server에서 제거될 예정입니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요.

[ @logicalname = ] 'logical_name' BACKUP 및 RESTORE 문에 사용되는 백업 디바이스의 논리적 이름입니다. logical_name 기본값이 없는 sysname이며 NULL일 수 없습니다.

[ @physicalname = ] 'physical_name' 백업 디바이스의 실제 이름입니다. 물리적 이름은 운영 체제 파일 이름에 적용되는 규칙 또는 네트워크 디바이스에 적용되는 UNC(Universal Naming Convention)를 따라야 하며 전체 경로를 포함해야 합니다. physical_name 기본값이 없는 nvarchar(260)이며 NULL일 수 없습니다.

원격 네트워크 위치에 백업 디바이스를 만들 때 데이터베이스 엔진이 시작된 이름에 원격 컴퓨터에 적절한 쓰기 기능이 있는지 확인합니다.

테이프 디바이스를 추가하는 경우 이 매개 변수는 Windows에서 로컬 테이프 디바이스에 할당된 실제 이름이어야 합니다. 예를 들어 컴퓨터의 첫 번째 테이프 디바이스에 대한 \\.\TAPE0 입니다. 테이프 디바이스는 원격 방식으로는 사용할 수 없으며 반드시 서버 컴퓨터에 연결되어야 합니다. 숫자 또는 알파벳이 아닌 문자를 포함한 이름은 앞뒤로 따옴표를 사용해야 합니다.

참고

이 프로시저에서는 지정한 물리적 이름을 카탈로그에 입력합니다. 이 프로시저는 디바이스에 액세스하거나 디바이스를 만들려고 시도하지 않습니다.

[ @cntrltype = ] 'controller_type' 되지 않는. 지정된 경우 이 매개 변수는 무시됩니다. 이전 버전과의 호환성을 위해서만 지원됩니다. sp_addumpdevice 새로운 용도는 이 매개 변수를 생략해야 합니다.

[ @devstatus = ] 'device_status' 되지 않는. 지정된 경우 이 매개 변수는 무시됩니다. 이전 버전과의 호환성을 위해서만 지원됩니다. sp_addumpdevice 새로운 용도는 이 매개 변수를 생략해야 합니다.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

None

설명

sp_addumpdevicesys.backup_devices 카탈로그 뷰 에 백업 디바이스를 추가합니다. 그런 다음 BACKUP 및 RESTORE 문에서 해당 디바이스를 논리적으로 참조할 수 있습니다. sp_addumpdevice 물리적 디바이스에 대한 액세스를 수행하지 않습니다. BACKUP 또는 RESTORE 문을 수행하는 경우에만 지정한 디바이스에 액세스합니다. 논리적 백업 디바이스를 만들면 "TAPE =" 또는 "DISK =" 절 대신 디바이스 이름을 사용하여 디바이스 경로를 지정할 수 있으므로 BACKUP 및 RESTORE 문이 간단해집니다.

소유권 및 사용 권한 문제가 디스크 또는 파일 백업 디바이스 사용을 방해하는 경우가 있습니다. 데이터베이스 엔진이 시작된 Windows 계정에 적절한 파일 권한이 부여되었는지 확인합니다.

데이터베이스 엔진은 Windows에서 지원하는 테이프 디바이스에 대한 테이프 백업을 지원합니다. Windows에서 지원되는 테이프 디바이스에 관한 자세한 내용은 Windows의 하드웨어 호환성 목록을 참조하십시오. 컴퓨터에서 사용할 수 있는 테이프 디바이스를 보려면 SQL Server Management Studio 사용합니다.

드라이브 제조업체가 권장하는 특정 테이프 드라이브에 대해서는 권장되는 테이프만 사용하십시오. DAT(디지털 오디오 테이프) 드라이브를 사용하는 경우 컴퓨터 등급 DAT 테이프(DDS: 디지털 데이터 스토리지)를 사용하십시오.

sp_addumpdevice 트랜잭션 내에서 실행할 수 없습니다.

디바이스를 삭제하려면 sp_dropdevice 사용하거나SQL Server Management Studio.

사용 권한

diskadmin 고정 서버 역할의 멤버 자격이 필요합니다.

디스크에 대한 쓰기 권한이 필요합니다.

예제

A. 디스크 덤프 디바이스 추가

다음 예에서는 mydiskdump이라는 물리적 이름으로 c:\dump\dump1.bak라는 디스크 백업 디바이스를 추가합니다.

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'mydiskdump', 'c:\dump\dump1.bak';  

B. 네트워크 디스크 백업 디바이스 추가

다음 예에서는 networkdevice라는 원격 디스크 백업 디바이스를 추가합니다. 데이터베이스 엔진이 시작된 이름에는 해당 원격 파일(\\<servername>\<sharename>\<path>\<filename>.bak)에 대한 권한이 있어야 합니다.

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'networkdevice',  
    '\\<servername>\<sharename>\<path>\<filename>.bak';  

C. 테이프 백업 디바이스 추가

다음 예에서는 tapedump1이라는 물리적 이름으로 \\.\tape0 디바이스를 추가합니다.

USE master;  
GO  
EXEC sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';  

D. 논리적 백업 디바이스에 백업

다음 예에서는 백업 디스크 파일에 대해 논리적 백업 디바이스인 AdvWorksData를 만듭니다. 그런 다음 AdventureWorks2019 데이터베이스를 이 논리적 백업 디바이스에 백업합니다.

USE master;  
GO  
EXEC sp_addumpdevice 'disk', 'AdvWorksData',   
'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';  
GO  
BACKUP DATABASE AdventureWorks2012   
 TO AdvWorksData  
   WITH FORMAT;  
GO  

참고 항목

백업 디바이스(SQL Server)
BACKUP(Transact-SQL)
Define a Logical Backup Device for a Disk File (SQL Server)
테이프 드라이브에 대한 논리적 백업 디바이스 정의(SQL Server)
RESTORE(Transact-SQL)
sp_dropdevice(Transact-SQL)
sys.backup_devices(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)