다음을 통해 공유

  • 아티클

sp_add_agent_profile(Transact-SQL)

복제 에이전트용 새 프로필을 작성합니다. 이 저장 프로시저는 모든 데이터베이스의 배포자에서 실행됩니다.

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

구문

sp_add_agent_profile [ [ @profile_id= ] profile_id OUTPUT ]
        , [ @profile_name= ] 'profile_name' 
        , [ @agent_type= ] 'agent_type' ] 
    [ , [ @profile_type= ] profile_type ]
    [ , [ @description= ] 'description' ]
    [ , [ @default= ] default ]

인수

  • [ @profile_id= ] profile_id
    새로 삽입된 프로필과 연결된 ID입니다. profile_id는 int이며 선택적인 OUTPUT 매개 변수입니다. 지정한 경우 값이 새 프로필 ID로 설정됩니다.

  • [ @profile_name= ] 'profile_name'
    프로필의 이름입니다. profile_name은 sysname이며 기본값은 없습니다.

  • [ @agent_type= ] 'agent_type'
    복제 에이전트의 유형입니다. agent_type은 int이고 기본값은 없으며 다음 값 중 하나일 수 있습니다.

    값

    설명

    1

    스냅숏 에이전트

    2

    로그 판독기 에이전트

    3

    배포 에이전트

    4

    병합 에이전트

    9

    큐 판독기 에이전트

  • [ @profile_type= ] profile_type
    프로필의 유형입니다.profile_type은 int이며 기본값은 1입니다.

    0은 시스템 프로필을 나타냅니다. 1은 사용자 지정 프로필을 나타냅니다. 저장 프로시저는 사용자 지정 프로필을 만드는 데만 사용할 수 있으므로 유효한 값은 1입니다. 시스템 프로필은 Microsoft SQL Server만 만들 수 있습니다.

  • [ @description =] 'description'
    프로필에 관한 설명입니다. description은 **nvarchar(3000)**이며 기본값은 없습니다.

  • [ @default= ] default
    프로필이 agent_type에 대한 기본값인지 여부를 나타냅니다. default는 bit이며 기본값은 0입니다. 1은 추가한 프로필이 agent_type이 지정한 에이전트의 새 기본 프로필이 됨을 나타냅니다.

반환 코드 값

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

주의

sp_add_agent_profile은 스냅숏 복제, 트랜잭션 복제 및 병합 복제에 사용됩니다.

사용자 지정 에이전트 프로필은 에이전트 매개 변수의 기본값으로 추가됩니다. sp_change_agent_parameter(Transact-SQL)을 사용하여 이러한 기본값을 변경하거나 sp_add_agent_parameter(Transact-SQL)를 사용하여 매개 변수를 추가하십시오.

sp_add_agent_profile을 실행하면 새 사용자 지정 프로필에 대한 하나의 행이 MSagent_profiles(Transact-SQL) 테이블에 추가되며 이 프로필에 대한 연관된 기본 매개 변수가 MSagent_parameters(Transact-SQL) 테이블에 추가됩니다.

사용 권한

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