sp_add_agent_parameter(Transact-SQL)

적용 대상:SQL ServerAzure SQL Managed Instance

에이전트 프로필에 새 매개 변수와 해당 값을 추가합니다. 이 저장 프로시저는 모든 데이터베이스의 배포자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

sp_add_agent_parameter [ @profile_id = ] profile_id
        , [ @parameter_name = ] 'parameter_name'
        , [ @parameter_value = ] 'parameter_value'
[ ; ]

인수

[ @profile_id = ] profile_id

데이터베이스에 있는 테이블의 MSagent_profiles 프로필 ID입니다 msdb . @profile_id 기본값이 없는 int입니다.

@profile_id 나타내는 에이전트 유형을 확인하려면 MSagent_profiles(Transact-SQL) 테이블에서 @profile_id 찾아 필드 값을 적어 agent_type 둡니다. 값은 다음과 같습니다.

설명
1 스냅샷 에이전트
2 로그 판독기 에이전트
3 배포 에이전트
4 병합 에이전트
9 큐 판독기 에이전트

[ @parameter_name = ] 'parameter_name'

매개 변수의 이름입니다. @parameter_name 기본값이 없는 sysname입니다. 시스템 프로필에 이미 정의된 매개 변수 목록은 복제 에이전트 프로필을 참조 하세요. 각 에이전트에 대해 유효한 매개 변수의 전체 목록은 다음 항목을 참조하십시오.

[ @parameter_value = ] 'parameter_value'

매개 변수에 할당할 값입니다. @parameter_value nvarchar(255)이며 기본값은 없습니다.

반환 코드 값

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

설명

sp_add_agent_parameter는 스냅샷 복제본(replica)tion, 트랜잭션 복제본(replica) 및 병합 복제본(replica)에 사용됩니다.

사용 권한

sysadmin 고정 서버 역할의 멤버만 실행할 sp_add_agent_parameter수 있습니다.