Partilhar via

sp_change_agent_parameter (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instâ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, É 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 esse profile_id representa, localize a coluna profile_id na 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

  • Otimização de rede máxima

  • 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

  • Intervalo de mensagens

  • 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

  • Tamanho do lote de confirmação

  • CommitBatchThreshold

  • Tipo de Transferência de Arquivos

  • HistóriaVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • Intervalo de mensagens

  • Saída

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • Identificador citado

  • Ignorar erros

  • TransactionsPerHistory

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

  • AltSnapshotFolder

  • BcpBatchSize

  • ChangesPerHistory

  • DestThreads

  • DownloadGenerationsPerBatch

  • DownloadReadChangesPerBatch

  • DownloadWriteChangesPerBatch

  • DynamicSnapshotLocation

  • Tipo de troca

  • Contagem de linhas rápidas

  • Tipo de Transferência de Arquivos

  • GenerationChangeThreshold

  • HistóriaVerboseLevel

  • Arquivo de mensagem de entrada

  • Resolução Interativa

  • InterruptOnMessagePattern

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDownloadChanges

  • MaxUploadChanges

  • Limpeza de retenção de metadados

  • NumDeadlockRetries

  • Saída

  • ArquivoMensagemSaída

  • 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 os profile_name associados ao profile_id. Com o profile_id apropriado, execute o próximo 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 (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.

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)