sp_add_proxy(Transact-SQL)
지정한 Microsoft 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 또는 빈 문자열인 경우 기본 프록시 이름은 지정한 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)를 사용하여 프록시에 다른 로그인 액세스 권한을 부여할 수 있습니다.
예
1. 프록시 만들기
다음 예에서는 자격 증명 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
참고 항목
참조
CREATE CREDENTIAL(Transact-SQL)
sp_grant_login_to_proxy(Transact-SQL)
sp_revoke_login_from_proxy(Transact-SQL)