sp_add_proxy(Transact-SQL)
적용 대상: SQL Server
지정된 SQL Server 에이전트 프록시를 추가합니다.
구문
sp_add_proxy
[ @proxy_name = ] 'proxy_name'
, [ @enabled = ] is_enabled
, [ @description = ] 'description'
, [ @credential_name = ] 'credential_name'
, [ @credential_id = ] credential_id
, [ @proxy_id = ] id OUTPUT
[ ; ]
인수
[ @proxy_name = ] 'proxy_name'
만들 프록시의 이름입니다. @proxy_name sysname이며 기본값은 .입니다NULL
. @proxy_name 또는 빈 문자열인 NULL
경우 프록시 이름은 기본적으로 제공된 @credential_name 또는 @credential_id 지정됩니다.
[ @enabled = ] is_enabled
프록시를 사용할 수 있는지 여부를 지정합니다. @enabled 플래그는 기본값1
인 tinyint입니다. @enabled 0
경우 프록시가 활성화되지 않으며 작업 단계에서 사용할 수 없습니다.
[ @description = ] 'description'
프록시에 대한 설명입니다. 설명은 nvarchar(512)이며 기본값은 .입니다 NULL
. 설명은 프록시를 문서화할 수 있지만 SQL Server 에이전트 사용되지 않습니다. 따라서 이 인수는 선택 사항입니다.
[ @credential_name = ] 'credential_name'
프록시에 대한 자격 증명의 이름입니다. @credential_name sysname이며 기본값은 .입니다NULL
. @credential_name 또는 @credential_id 지정해야 합니다.
[ @credential_id = ] credential_id
프록시에 대한 자격 증명의 ID 번호입니다. @credential_id int이며 기본값은 .입니다NULL
. @credential_name 또는 @credential_id 지정해야 합니다.
[ @proxy_id = ] proxy_id OUTPUT
성공적으로 만들어진 경우 프록시에 할당된 프록시 ID 번호입니다.
반환 코드 값
0
(성공) 또는 1
(실패).
결과 집합
없음.
설명
이 저장 프로시저는 데이터베이스에서 msdb
실행해야 합니다.
SQL Server 에이전트 프록시는 Transact-SQL 하위 시스템 이외의 하위 시스템을 포함하는 작업 단계에 대한 보안을 관리합니다. 각 프록시는 보안 자격 증명에 해당됩니다. 프록시는 여러 하위 시스템에 액세스할 수 있습니다.
사용 권한
이 절차에 대한 사용 권한을 부여 EXECUTE
할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.
sysadmin 고정 보안 역할의 멤버는 프록시를 사용하는 작업 단계를 만들 수 있습니다. 저장 프로시저 sp_grant_login_to_proxy 사용하여 프록시에 대한 다른 로그인 액세스 권한을 부여합니다.
예제
이 예제에서는 자격 증명 CatalogApplicationCredential
에 대한 프록시를 만듭니다. 이 코드는 자격 증명이 이미 있다고 가정합니다. 자격 증명에 대한 자세한 내용은 CREATE CREDENTIAL을 참조 하세요.
USE msdb;
GO
EXEC dbo.sp_add_proxy
@proxy_name = 'Catalog application proxy',
@enabled = 1,
@description = 'Maintenance tasks on catalog application.',
@credential_name = 'CatalogApplicationCredential';
GO