sp_change_agent_parameter(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL Managed Instance

MSagent_parameters 시스템 테이블에 저장된 복제본(replica)tion 에이전트 프로필의 매개 변수를 변경합니다. 이 저장 프로시저는 에이전트가 실행 중인 배포자에서 모든 데이터베이스에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

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

인수

[ @profile_id = ] profile_id, 프로필의 ID입니다. profile_id 기본값이 없는 int입니다.

[ @parameter_name = ] 'parameter_name' 매개 변수의 이름입니다. parameter_name sysname이며 기본값은 없습니다. 시스템 프로필의 경우 변경될 수 있는 매개 변수는 에이전트의 유형에 따라 달라집니다 이 profile_id 나타내는 에이전트 유형을 확인하려면 Msagent_profiles 테이블에서 profile_id 열을 찾아 agent_type 값을 적어둡니다.

참고 항목

지정된 agent_type 대해 매개 변수가 지원되지만 에이전트 프로필에 정의되지 않은 경우 오류가 반환됩니다. 에이전트 프로필에 매개 변수를 추가하려면 sp_add_agent_parameter 실행해야 합니다.

프로필에 정의된 경우 스냅샷 에이전트(agent_type=1)의 경우 다음 속성을 변경할 수 있습니다.

  • 70Subscribers

  • BcpBatchSize

  • HistoryVerboseLevel

  • LoginTimeout

  • MaxBcpThreads

  • MaxNetworkOptimization

  • 출력

  • OutputVerboseLevel

  • PacketSize

  • QueryTimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

로그 판독기 에이전트(agent_type=2)의 경우 프로필에 정의된 경우 다음 속성을 변경할 수 있습니다.

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • 출력

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • ReadBatchSize

  • ReadBatchThreshold

배포 에이전트(agent_type=3)의 경우 프로필에 정의된 경우 다음 속성을 변경할 수 있습니다.

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistoryVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • 출력

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • QuotedIdentifier

  • Skiperrors

  • TransactionsPerHistory

병합 에이전트(agent_type=4)의 경우 프로필에 정의된 경우 다음 속성을 변경할 수 있습니다.

  • AltSnapshotFolder

  • BcpBatchSize

  • ChangesPerHistory

  • DestThreads

  • DownloadGenerationsPerBatch

  • DownloadReadChangesPerBatch

  • DownloadWriteChangesPerBatch

  • DynamicSnapshotLocation

  • ExchangeType

  • FastRowCount

  • FileTransferType

  • GenerationChangeThreshold

  • HistoryVerboseLevel

  • InputMessageFile

  • InteractiveResolution

  • InterruptOnMessagePattern

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDownloadChanges

  • MaxUploadChanges

  • MetadataRetentionCleanup

  • NumDeadlockRetries

  • 출력

  • OutputMessageFile

  • OutputVerboseLevel

  • PacketSize

  • ParallelUploadDownload

  • PauseOnMessagePattern

  • PauseTime

  • PollingInterval

  • ProcessMessagesAtPublisher

  • ProcessMessagesAtSubscriber

  • QueryTimeout

  • QueueSizeMultiplier

  • SrcThreads

  • StartQueueTimeout

  • SyncToAlternate

  • UploadGenerationsPerBatch

  • UploadReadChangesPerBatch

  • UploadWriteChangesPerBatch

  • UseInprocLoader

  • 유효성 검사

  • ValidateInterval

큐 판독기 에이전트(agent_type=9)의 경우 프로필에 정의된 경우 다음 속성을 변경할 수 있습니다.

  • HistoryVerboseLevel

  • LoginTimeout

  • 출력

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

지정된 프로필에 대해 정의된 매개 변수를 확인하려면 sp_help_agent_profile 실행하고 profile_id 연결된 profile_name 기록해 둡다. 적절한 profile_id 사용하여 해당 profile_id 사용하여 sp_help_agent_parameters 실행하여 프로필과 연결된 매개 변수를 확인합니다. 매개 변수는 sp_add_agent_parameter 실행하여 프로필에 추가할 수 있습니다.

[ @parameter_value = ] 'parameter_value' 매개 변수의 새 값입니다. parameter_value nvarchar(255)이며 기본값은 없습니다.

반환 코드 값

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

설명

sp_change_agent_parameter 모든 유형의 복제본(replica) 사용됩니다.

사용 권한

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

참고 항목

복제 에이전트 프로필
Replication Distribution Agent
복제 로그 판독기 에이전트
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent
sp_add_agent_parameter(Transact-SQL)
sp_drop_agent_parameter(Transact-SQL)
sp_help_agent_parameter(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)