sp_change_agent_parameter (Transact-SQL)

Artigo
05/07/2013

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.

Observação
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.