sp_change_agent_parameter (Transact-SQL)

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.

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.

• [ @parameter_value=] 'parameter_value'
  É o novo valor do parâmetro. parameter_value é nvarchar(255), sem padrão.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_change_agent_parameter é usado em todos os tipos de replicação.

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_change_agent_parameter.

Consulte também

Referência

Perfis do Agente de Replicação

Agente de Distribuição de Replicação

Replication Agente de Leitor de Log

Replication Merge Agent

Replication Queue Reader Agent

Replication Snapshot Agent

sp_add_agent_parameter (Transact-SQL)

sp_drop_agent_parameter (Transact-SQL)

sp_help_agent_parameter (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)