sp_change_agent_parameter(Transact-SQL)
적용 대상:SQL ServerAzure SQL Managed Instance
MSagent_parameters 시스템 테이블에 저장된 복제본(replica)tion 에이전트 프로필의 매개 변수를 변경합니다. 이 저장 프로시저는 에이전트가 실행 중인 배포자에서 모든 데이터베이스에서 실행됩니다.
구문
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)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기