다음을 통해 공유

sp_change_agent_parameter(Transact-SQL)

  • 아티클

적용 대상: SQL Server Azure SQL Managed Instance

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

Transact-SQL 구문 표기 규칙

구문

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

인수

[ @profile_id = ] profile_id

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

[ @parameter_name = ] N'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
  • Output
  • OutputVerboseLevel
  • PacketSize
  • QueryTimeout
  • StartQueueTimeout
  • UsePerArticleContentsView

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

  • HistoryVerboseLevel
  • LoginTimeout
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • ReadBatchSize
  • ReadBatchThreshold

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

  • BcpBatchSize
  • CommitBatchSize
  • CommitBatchThreshold
  • FileTransferType
  • HistoryVerboseLevel
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDeliveredTransactions
  • MessageInterval
  • Output
  • 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
  • Output
  • OutputMessageFile
  • OutputVerboseLevel
  • PacketSize
  • ParallelUploadDownload
  • PauseOnMessagePattern
  • PauseTime
  • PollingInterval
  • ProcessMessagesAtPublisher
  • ProcessMessagesAtSubscriber
  • QueryTimeout
  • QueueSizeMultiplier
  • SrcThreads
  • StartQueueTimeout
  • SyncToAlternate
  • UploadGenerationsPerBatch
  • UploadReadChangesPerBatch
  • UploadWriteChangesPerBatch
  • UseInprocLoader
  • Validate
  • ValidateInterval

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

  • HistoryVerboseLevel
  • LoginTimeout
  • Output
  • OutputVerboseLevel
  • PollingInterval
  • QueryTimeout
  • ResolverState
  • SQLQueueMode

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

[ @parameter_value = ] N'parameter_value'

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

반환 코드 값

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

설명

sp_change_agent_parameter 는 모든 유형의 복제에서 사용됩니다.

사용 권한

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

관련 콘텐츠