sp_add_agent_profile(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL Managed Instance

복제본(replica) 에이전트에 대한 새 프로필을 만듭니다. 이 저장 프로시저는 모든 데이터베이스의 배포자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

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

인수

[ @profile_id = ] profile_id

새로 삽입된 프로필과 연결된 ID입니다. @profile_id int이며 선택적 OUTPUT 매개 변수입니다. 지정하면 값이 새 프로필 ID로 설정됩니다.

[ @profile_name = ] 'profile_name'

프로필의 이름입니다. @profile_name 기본값이 없는 sysname입니다.

[ @agent_type = ] agent_type

복제본(replica) 에이전트의 유형입니다. @agent_type 기본값 없이 int이며 이러한 값 중 하나일 수 있습니다.

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

[ @profile_type = ] profile_type

프로필의 형식입니다. profile_type 기본값1인 int입니다.

0 는 시스템 프로필을 나타냅니다. 1 는 사용자 지정 프로필을 나타냅니다. 이 저장 프로시저를 사용하여 사용자 지정 프로필만 만들 수 있습니다. 따라서 유효한 값은 .입니다 1. SQL Server만 시스템 프로필을 만듭니다.

[ @description = ] N'description'

프로필에 대한 설명입니다. @description nvarchar(3000)이며 기본값은 없습니다.

[ @default = ] default

프로필이 @agent_type 기본값인지 여부를 나타냅니다. @default 비트이며 기본값은 .입니다0. 1는 추가되는 프로필이 @agent_type 지정된 에이전트의 새 기본 프로필이 됨을 나타냅니다.

반환 코드 값

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

설명

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

사용자 지정 에이전트 프로필은 기본 에이전트 매개 변수 값으로 추가됩니다. 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수 있습니다.

관련 콘텐츠