sp_change_agent_parameter (Transact-SQL)

Artigo
03/07/2014

Altera um parâmetro de um perfil de agente de replicação armazenado na tabela do sistema MSagent_parameters. Esse procedimento armazenado é executado no Distribuidor, onde o agente está sendo executado, ou em qualquer banco de dados.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @profile_id=] profile_id,
É a ID do perfil. profile_id é int, sem padrão.
[ @parameter_name=] 'parameter_name'
É o nome do parâmetro. parameter_name é sysname, sem padrão. Para perfis de sistema, os parâmetros que podem ser alterados dependem do tipo de agente. Para descobrir que tipo de agente esta profile_id representa, localize a coluna profile_id na tabela Msagent_profiles e observe o valor agent_type.

Dica

Se um parâmetro tiver suporte para um determinado agent_type, mas não foi definido no perfil do agente, um erro será retornado.Para adicionar um parâmetro a um perfil de agente, você deve executar sp_add_agent_parameter.

Para um Snapshot Agent (agent_type=1), se definido no perfil, as propriedades seguintes podem ser alteradas:
- 70Subscribers
- BcpBatchSize
- HistoryVerboseLevel
- LoginTimeout
- MaxBcpThreads
- MaxNetworkOptimization
- Saída
- OutputVerboseLevel
- PacketSize
- QueryTimeout
- StartQueueTimeout
- UsePerArticleContentsView
Para um Log Reader Agent (agent_type=2), se definido no perfil, as propriedades seguintes podem ser alteradas:
- HistoryVerboseLevel
- LoginTimeout
- MessageInterval
- Saída
- OutputVerboseLevel
- PacketSize
- PollingInterval
- QueryTimeout
- ReadBatchSize
- ReadBatchThreshold
Para um Distribution Agent (agent_type=3), se definido no perfil, as propriedades seguintes podem ser alteradas:
- BcpBatchSize
- CommitBatchSize
- CommitBatchThreshold
- FileTransferType
- HistoryVerboseLevel
- KeepAliveMessageInterval
- LoginTimeout
- MaxBcpThreads
- MaxDeliveredTransactions
- MessageInterval
- Saída
- OutputVerboseLevel
- PacketSize
- PollingInterval
- QueryTimeout
- QuotedIdentifier
- SkipErrors
- TransactionsPerHistory
Para um Merge Agent (agent_type=4), se definido no perfil, as propriedades seguintes podem ser alteradas:
- AltSnapshotFolder
- BcpBatchSize
- ChangesPerHistory
- DestThreads
- DownloadGenerationsPerBatch
- DownloadReadChangesPerBatch
- DownloadWriteChangesPerBatch
- DynamicSnapshotLocation
- ExchangeType
- FastRowCount
- FileTransferType
- GenerationChangeThreshold
- HistoryVerboseLevel
- InputMessageFile
- InteractiveResolution
- InterruptOnMessagePattern
- KeepAliveMessageInterval
- LoginTimeout
- MaxBcpThreads
- MaxDownloadChanges
- MaxUploadChanges
- MetadataRetentionCleanup
- NumDeadlockRetries
- Saída
- OutputMessageFile
- OutputVerboseLevel
- PacketSize
- ParallelUploadDownload
- PauseOnMessagePattern
- PauseTime
- PollingInterval
- ProcessMessagesAtPublisher
- ProcessMessagesAtSubscriber
- QueryTimeout
- QueueSizeMultiplier
- SrcThreads
- StartQueueTimeout
- SyncToAlternate
- UploadGenerationsPerBatch
- UploadReadChangesPerBatch
- UploadWriteChangesPerBatch
- UseInprocLoader
- Validar
- ValidateInterval
Para um Queue Reader Agent (agent_type=9), se definido no perfil as propriedades seguintes poderão ser alteradas:
- HistoryVerboseLevel
- LoginTimeout
- Saída
- OutputVerboseLevel
- PollingInterval
- QueryTimeout
- ResolverState
- SQLQueueMode
Para consultar quais parâmetros foram determinados para um determinado perfil, execute sp_help_agent_profile e observe o profile_name associado a profile_id. Com a profile_id apropriada, em seguida execute sp_help_agent_parameters usando essa profile_id para consultar os parâmetros associados ao perfil. Parâmetros podem ser adicionados a um perfil executando sp_add_agent_parameter.
[ @parameter_value=] 'parameter_value'
É o novo valor do parâmetro. parameter_value é nvarchar(255), sem padrão.