sp_change_agent_parameter (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

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 de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

[ @profile_id = ] profile_id, É o 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 esse profile_id representa, localize a coluna profile_idna tabela Msagent_profiles e anote o valor agent_type.

Observação

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

Para um Snapshot Agent (agent_type=1), se definido no perfil, as seguintes propriedades podem ser alteradas:

  • 70Assinantes

  • BcpBatchSize

  • HistóriaVerboseLevel

  • LoginTimeout

  • MaxBcpThreads

  • MaxNetworkOptimization

  • Saída

  • OutputVerboseLevel

  • PacketSize

  • QueryTimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

Para um Log Reader Agent (agent_type=2), se definido no perfil, as seguintes propriedades podem ser alteradas:

  • HistóriaVerboseLevel

  • LoginTimeout

  • MessageInterval

  • Saída

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • ReadBatchSize

  • ReadBatchThreshold

Para um Agente de Distribuição (agent_type=3), se definido no perfil, as seguintes propriedades podem ser alteradas:

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistóriaVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • Saída

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • QuotedIdentifier

  • SkipErrors

  • TransaçõesPerHistory

Para um Merge Agent (agent_type=4), se definido no perfil, as seguintes propriedades podem ser alteradas:

  • AltSnapshotFolder

  • BcpBatchSize

  • AlteraçõesPerHistória

  • DestThreads

  • BaixarGenerationsPerBatch

  • BaixarReadChangesPerBatch

  • BaixarWriteChangesPerBatch

  • DynamicSnapshotLocation

  • Tipo de Troca

  • FastRowCount

  • FileTransferType

  • GenerationChangeThreshold

  • HistóriaVerboseLevel

  • InputMessageFile

  • Resolução Interativa

  • InterruptOnMessagePattern

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDownloadAlterações

  • MaxUploadAlterações

  • MetadataRetentionCleanup

  • NumDeadlockRepetições

  • Saída

  • OutputMessageFile

  • OutputVerboseLevel

  • PacketSize

  • ParallelUploadBaixar

  • PauseOnMessagePattern

  • Tempo de pausa

  • 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 seguintes propriedades podem ser alteradas:

  • HistóriaVerboseLevel

  • LoginTimeout

  • Saída

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

Para ver quais parâmetros foram definidos para um determinado perfil, execute sp_help_agent_profile e observe as profile_name associadas ao profile_id. Com a profile_id apropriada, execute sp_help_agent_parameters usando esse profile_id para ver os parâmetros associados ao perfil. Os 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 do código de retorno

0 (sucesso) ou 1 (fracasso)

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.

Confira também

Perfis do agente de replicação
Replication Distribution Agent
Agente do Leitor de Log de Replicação
Replication Merge Agent
Agente de Leitor de Fila de Replicação
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)