다음을 통해 공유


sp_add_proxy(Transact-SQL)

지정된 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 또는 빈 문자열인 경우 기본 프록시 이름은 지정한 user_name입니다.

  • [ @enabled = ] is_enabled
    프록시 활성화 여부를 지정합니다. is_enabled 플래그는 tinyint이며 기본값은 1입니다. is_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= ] id OUTPUT
    프록시를 성공적으로 만든 경우 프록시에 할당되는 프록시 ID입니다.

반환 코드 값

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

결과 집합

없음

주의

이 저장 프로시저는 msdb 데이터베이스에서 실행해야 합니다.

SQL Server 에이전트 프록시는 Transact-SQL 하위 시스템 이외의 하위 시스템과 연관된 작업 단계의 보안을 관리합니다. 각 프록시는 보안 자격 증명에 해당됩니다. 프록시에서 원하는 수만큼의 하위 시스템에 액세스할 수 있습니다.

사용 권한

sysadmin 고정 보안 역할의 멤버만 이 프로시저를 실행할 수 있습니다.

sysadmin 고정 보안 역할의 멤버는 프록시를 사용하는 작업 단계를 만들 수 있습니다. 저장 프로시저 sp_grant_login_to_proxy(Transact-SQL)를 사용하여 프록시에 다른 로그인 액세스 권한을 부여할 수 있습니다.

다음 예에서는 자격 증명 CatalogApplicationCredential에 대한 프록시를 만듭니다. 이 코드는 자격 증명이 이미 있는 것으로 가정합니다. 자격 증명에 대한 자세한 내용은 CREATE CREDENTIAL(Transact-SQL)을 참조하십시오.

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