sp_change_agent_parameter (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 托管实例

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

Transact-SQL 语法约定

语法

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

参数

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

[ @parameter_name = ] 'parameter_name' 参数的名称。 parameter_name为 sysname，没有默认值。 对于系统配置文件，可以更改的参数取决于代理的类型。 若要了解此profile_id表示的代理类型，请在Msagent_profiles表中找到profile_id列，并记下agent_type值。

注意

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

对于快照代理（agent_type=1），如果在配置文件中定义，则可以更改以下属性：

  • 70Subscribers

  • BcpBatchSize

  • HistoryVerboseLevel

  • LoginTimeout

  • MaxBcpThreads

  • MaxNetworkOptimization

  • 输出

  • OutputVerboseLevel

  • PacketSize

  • QueryTimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

对于日志读取器代理（agent_type=2），如果在配置文件中定义，则可以更改以下属性：

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • 输出

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • ReadBatchSize

  • ReadBatchThreshold

对于分发代理（agent_type=3），如果在配置文件中定义，则可以更改以下属性：

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistoryVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • 输出

  • 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

  • 输出

  • OutputMessageFile

  • OutputVerboseLevel

  • PacketSize

  • ParallelUploadDownload

  • PauseOnMessagePattern

  • PauseTime

  • PollingInterval

  • ProcessMessagesAtPublisher

  • ProcessMessagesAtSubscriber

  • QueryTimeout

  • QueueSizeMultiplier

  • SrcThreads

  • StartQueueTimeout

  • SyncToAlternate

  • UploadGenerationsPerBatch

  • UploadReadChangesPerBatch

  • UploadWriteChangesPerBatch

  • UseInprocLoader

  • 验证

  • ValidateInterval

对于队列读取器代理（agent_type=9），如果在配置文件中定义，则可以更改以下属性：

  • HistoryVerboseLevel

  • LoginTimeout

  • 输出

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

若要查看为给定配置文件定义的参数，请运行sp_help_agent_profile并记下与profile_id关联的profile_name。 使用适当的profile_id，接下来运行sp_help_agent_parameters使用该profile_id查看与配置文件关联的参数。 可以通过执行 sp_add_agent_parameter将参数添加到配置文件。

[ @parameter_value = ] 'parameter_value' 参数的新值。 parameter_value 为 nvarchar（255），没有默认值。

返回代码值

0 （成功） 或 1 （失败）

注解

sp_change_agent_parameter用于所有类型的副本 (replica)。

权限

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

另请参阅

复制代理配置文件
Replication Distribution Agent
复制日志读取器代理
Replication Merge Agent
复制队列读取器代理
Replication Snapshot Agent
sp_add_agent_parameter （Transact-SQL）
sp_drop_agent_parameter （Transact-SQL）
sp_help_agent_parameter （Transact-SQL）
系统存储过程 (Transact-SQL)