sp_change_agent_parameter (Transact-SQL)

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 = ] N'parameter_name'
    , [ @parameter_value = ] N'parameter_value'
[ ; ]

Argumentos

@profile_id [ = ] profile_id

A ID do perfil. @profile_id é int, sem padrão.

@parameter_name [ = ] N'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 profile_id Msagent_profiles coluna na tabela e anote o agent_type valor.

Se um parâmetro for compatível com um determinado agent_type, mas não estiver 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:

  • 70Subscribers
  • BcpBatchSize
  • HistoryVerboseLevel
  • LoginTimeout
  • MaxBcpThreads
  • MaxNetworkOptimization
  • Output
  • OutputVerboseLevel
  • PacketSize
  • QueryTimeout
  • StartQueueTimeout
  • UsePerArticleContentsView

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

  • HistoryVerboseLevel
  • LoginTimeout
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • ReadBatchSize
  • ReadBatchThreshold

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

  • BcpBatchSize
  • CommitBatchSize
  • CommitBatchThreshold
  • FileTransferType
  • HistoryVerboseLevel
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDeliveredTransactions
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • QuotedIdentifier
  • SkipErrors
  • 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
  • ExchangeType
  • FastRowCount
  • FileTransferType
  • GenerationChangeThreshold
  • HistoryVerboseLevel
  • InputMessageFile
  • InteractiveResolution
  • InterruptOnMessagePattern
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDownloadChanges
  • MaxUploadChanges
  • MetadataRetentionCleanup
  • NumDeadlockRetries
  • Output
  • OutputMessageFile
  • OutputVerboseLevel
  • PacketSize
  • ParallelUploadDownload
  • PauseOnMessagePattern
  • PauseTime
  • PollingInterval
  • ProcessMessagesAtPublisher
  • ProcessMessagesAtSubscriber
  • QueryTimeout
  • QueueSizeMultiplier
  • SrcThreads
  • StartQueueTimeout
  • SyncToAlternate
  • UploadGenerationsPerBatch
  • UploadReadChangesPerBatch
  • UploadWriteChangesPerBatch
  • UseInprocLoader
  • Validate
  • ValidateInterval

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

  • HistoryVerboseLevel
  • LoginTimeout
  • Output
  • OutputVerboseLevel
  • PollingInterval
  • QueryTimeout
  • ResolverState
  • SQLQueueMode

Para ver quais parâmetros são definidos para um determinado perfil, execute sp_help_agent_profile e anote o profile_name associado ao profile_id. Com o , profile_idexecute o , apropriado sp_help_agent_parameters , usando-o 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 [ = ] N'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.