• 아티클

sp_add_agent_parameter(Transact-SQL)

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

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

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

인수

  • [ @profile_id= ] profile_id
    msdb 데이터베이스에 있는 MSagent_profiles 테이블의 프로필 ID입니다. 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는 스냅숏 복제, 트랜잭션 복제 및 병합 복제에 사용됩니다.

사용 권한

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