다음을 통해 공유


sp_add_proxy(Transact-SQL)

적용 대상: SQL Server

지정된 SQL Server 에이전트 프록시를 추가합니다.

Transact-SQL 구문 표기 규칙

구문

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