Partilhar via


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.

Ícone de vínculo de tópicoConvenções de 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çãoObservaçã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

    • Output

    • 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

    • Output

    • 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

    • Output

    • 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

    • 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 propriedades seguintes poderão ser alteradas:

    • HistoryVerboseLevel

    • LoginTimeout

    • Output

    • 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.