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를 실행할 수 있습니다.

참고 항목

참조

sp_add_agent_parameter(Transact-SQL)
sp_drop_agent_parameter(Transact-SQL)
sp_help_agent_parameter(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)

관련 자료

복제 에이전트 프로필
Replication Distribution Agent
Replication Log Reader Agent
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent

도움말 및 정보

SQL Server 2005 지원 받기