sp_change_agent_parameter (Transact-SQL)

适用于: SQL Server Azure SQL 托管实例

更改存储在MSagent_parameters系统表中的复制代理配置文件的参数。 此存储过程可在运行代理的分发服务器的任意数据库中执行。

Transact-SQL 语法约定

语法

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

参数

[ @profile_id = ] profile_id

配置文件的 ID。 @profile_id为 int,无默认值。

[ @parameter_name = ] N'parameter_name'

参数的名称。 @parameter_namesysname,无默认值。 对于系统配置文件,可以更改的参数取决于代理的类型。 若要了解此 @profile_id 表示的代理类型,请在表中找到该 profile_idMsagent_profiles ,并记下 agent_type 该值。

如果给定 agent_type参数受支持,但未在代理配置文件中定义,则返回错误。 若要将参数添加到代理配置文件,必须执行 sp_add_agent_parameter

对于快照代理(agent_type = 1),如果在配置文件中定义,可以更改以下属性:

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

对于日志读取器代理(agent_type = 2如果在配置文件中定义),可以更改以下属性:

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

对于分发代理(agent_type = 3),如果在配置文件中定义,可以更改以下属性:

  • BcpBatchSize
  • CommitBatchSize
  • CommitBatchThreshold
  • FileTransferType
  • HistoryVerboseLevel
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDeliveredTransactions
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • QuotedIdentifier
  • SkipErrors
  • TransactionsPerHistory

对于合并代理(agent_type = 4),如果在配置文件中定义,可以更改以下属性:

  • 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

对于队列读取器代理(agent_type = 9如果已在配置文件中定义),可以更改以下属性:

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

若要查看为给定配置文件定义的参数,请运行 sp_help_agent_profile 并记 profile_name 下与该 profile_id配置文件关联的参数。 在适当的profile_id情况下,下一次使用该profile_idsp_help_agent_parameters函数查看与配置文件关联的参数。 可以通过执行 sp_add_agent_parameter将参数添加到配置文件。

[ @parameter_value = ] N'parameter_value'

参数的新值。 @parameter_valuenvarchar(255),没有默认值。

返回代码值

0(成功)或 1(失败)。

注解

sp_change_agent_parameter 用于所有类型的复制。

权限

只有 sysadmin 固定服务器角色的成员才能执行sp_change_agent_parameter