다음을 통해 공유

  • 아티클

sp_change_agent_parameter(Transact-SQL)

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

항목 링크 아이콘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

    • 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_name을 기록합니다. 적절한 profile_id를 사용하면 다음 sp_help_agent_parameters 실행에 해당 profile_id를 사용하여 프로필과 연결된 매개 변수를 확인할 수 있습니다. sp_add_agent_parameter를 실행하여 프로필에 매개 변수를 추가할 수 있습니다.

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

반환 코드 값

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

주의

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

사용 권한

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