다음을 통해 공유


sp_addumpdevice(Transact-SQL)

적용 대상: SQL Server

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

Transact-SQL 구문 표기 규칙

구문

sp_addumpdevice
    [ @devtype = ] 'devtype'
    , [ @logicalname = ] N'logicalname'
    , [ @physicalname = ] N'physicalname'
    [ , [ @cntrltype = ] cntrltype ]
    [ , [ @devstatus = ] 'devstatus' ]
[ ; ]

인수

[ @devtype = ] 'devtype'

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

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

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

[ @logicalname = ] N'logicalname'

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

[ @physicalname = ] N'physicalname'

백업 디바이스의 실제 이름입니다. @physicalname nvarchar(260)이며, 기본값이 없으므로 사용할 수 없습니다NULL. 물리적 이름은 운영 체제 파일 이름 또는 네트워크 디바이스에 대한 범용 명명 규칙을 따라야 하며 전체 경로를 포함해야 합니다.

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

테이프 디바이스를 추가하는 경우 이 매개 변수는 Windows에서 로컬 테이프 디바이스에 할당된 실제 이름이어야 합니다. 예를 들어 컴퓨터 \\.\TAPE0 의 첫 번째 테이프 디바이스의 경우입니다. 테이프 디바이스를 서버 컴퓨터에 연결해야 합니다. 원격으로 사용할 수 없습니다. 숫자가 아닌 문자가 포함된 이름을 따옴표로 묶습니다.

참고 항목

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

[ @cntrltype = ] cntrltype

사용되지 않습니다. 지정한 경우 이 매개 변수는 무시됩니다. 이전 버전과의 호환성을 지원합니다. 새 용도는 sp_addumpdevice 이 매개 변수를 생략해야 합니다.

[ @devstatus = ] 'devstatus'

사용되지 않습니다. 지정한 경우 이 매개 변수는 무시됩니다. 이전 버전과의 호환성을 지원합니다. 새 용도는 sp_addumpdevice 이 매개 변수를 생략해야 합니다.

반환 코드 값

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

결과 집합

없음.

설명

sp_addumpdevice 는 카탈로그 뷰에 백업 디바이스를 sys.backup_devices 추가합니다. 그런 다음 디바이스를 논리적으로 및 RESTORE 문으로 BACKUP 참조할 수 있습니다. sp_addumpdevice 는 물리적 디바이스에 대한 액세스를 수행하지 않습니다. 지정된 디바이스에 대한 액세스는 또는 RESTORE 문이 수행될 때만 BACKUP 발생합니다. 논리 백업 디바이스를 만들면 디바이스 이름을 지정하는 것이 디바이스 경로를 지정하기 위한 또는 DISK = 절을 사용하는 TAPE = 대안인 간단한 BACKUP 명령문과 RESTORE 명령문을 만들 수 있습니다.

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

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

드라이브 제조업체에서 제안하는 특정 테이프 드라이브에 권장되는 테이프만 사용합니다. DAT(디지털 오디오 테이프) 드라이브를 사용하는 경우 컴퓨터급 DAT 테이프(DDS(Digital Data Storage))를 사용합니다.

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

디바이스를 삭제하려면 sp_dropdevice 사용하거나 백업 디바이스를 삭제합니다(SQL Server).

사용 권한

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. 테이프 백업 디바이스 추가

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

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

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

다음 예제에서는 백업 디스크 파일에 대한 논리 백업 디바이스 AdvWorksData를 만듭니다. 그런 다음 이 논리 백업 디바이스에 AdventureWorks2022 데이터베이스를 백업하는 예제입니다.

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