sys.sp_change_agent_parameter (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Altera um parâmetro de um perfil de agente de replicação armazenado na tabela do sistema MSagent_parameters . Este procedimento armazenado é executado no Distribuidor onde o agente está a correr, em qualquer base de dados.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_change_agent_parameter
    [ @profile_id = ] profile_id
    , [ @parameter_name = ] N'parameter_name'
    , [ @parameter_value = ] N'parameter_value'
[ ; ]

Arguments

[ @profile_id = ] profile_id

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

[ @parameter_name = ] N'parameter_name'

O nome do parâmetro. @parameter_name é sysname, sem predefinição. Para perfis de sistema, os parâmetros que podem ser alterados dependem do tipo de agente. Para saber que tipo de agente este @profile_id representa, localize a profile_id coluna na Msagent_profiles tabela e anote o agent_type valor.

Se um parâmetro for suportado para um dado agent_type, mas não estiver definido no perfil do agente, é devolvido um erro. Para adicionar um parâmetro ao perfil de um agente, deve executar 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 Agente Leitor de Logs (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 Agente Leitor de Fila (agent_type = 9), se definido no perfil, as seguintes propriedades podem ser alteradas:

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

Para ver que parâmetros estão definidos para um dado perfil, execute sp_help_agent_profile e note o associado profile_name ao profile_id. Com o apropriado profile_id, executa sp_help_agent_parameters a seguir usando isso 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 de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

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

Permissions

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

Conteúdo relacionado

  • Last updated on