适用于: SQL Server
Azure SQL 托管实例
更改存储在MSagent_parameters系统表中的复制代理配置文件的参数。 此存储过程可在运行代理的分发服务器的任意数据库中执行。
语法
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_name 为 sysname,无默认值。 对于系统配置文件,可以更改的参数取决于代理的类型。 若要了解此 @profile_id 表示的代理类型,请在表中找到该 profile_id 列 Msagent_profiles ,并记下 agent_type 该值。
如果给定 agent_type参数受支持,但未在代理配置文件中定义,则返回错误。 若要将参数添加到代理配置文件,必须执行 sp_add_agent_parameter。
对于快照代理(agent_type = 1),如果在配置文件中定义,可以更改以下属性:
70SubscribersBcpBatchSizeHistoryVerboseLevelLoginTimeoutMaxBcpThreadsMaxNetworkOptimizationOutputOutputVerboseLevelPacketSizeQueryTimeoutStartQueueTimeoutUsePerArticleContentsView
对于日志读取器代理(agent_type = 2如果在配置文件中定义),可以更改以下属性:
HistoryVerboseLevelLoginTimeoutMessageIntervalOutputOutputVerboseLevelPacketSizePollingIntervalQueryTimeoutReadBatchSizeReadBatchThreshold
对于分发代理(agent_type = 3),如果在配置文件中定义,可以更改以下属性:
BcpBatchSizeCommitBatchSizeCommitBatchThresholdFileTransferTypeHistoryVerboseLevelKeepAliveMessageIntervalLoginTimeoutMaxBcpThreadsMaxDeliveredTransactionsMessageIntervalOutputOutputVerboseLevelPacketSizePollingIntervalQueryTimeoutQuotedIdentifierSkipErrorsTransactionsPerHistory
对于合并代理(agent_type = 4),如果在配置文件中定义,可以更改以下属性:
AltSnapshotFolderBcpBatchSizeChangesPerHistoryDestThreadsDownloadGenerationsPerBatchDownloadReadChangesPerBatchDownloadWriteChangesPerBatchDynamicSnapshotLocationExchangeTypeFastRowCountFileTransferTypeGenerationChangeThresholdHistoryVerboseLevelInputMessageFileInteractiveResolutionInterruptOnMessagePatternKeepAliveMessageIntervalLoginTimeoutMaxBcpThreadsMaxDownloadChangesMaxUploadChangesMetadataRetentionCleanupNumDeadlockRetriesOutputOutputMessageFileOutputVerboseLevelPacketSizeParallelUploadDownloadPauseOnMessagePatternPauseTimePollingIntervalProcessMessagesAtPublisherProcessMessagesAtSubscriberQueryTimeoutQueueSizeMultiplierSrcThreadsStartQueueTimeoutSyncToAlternateUploadGenerationsPerBatchUploadReadChangesPerBatchUploadWriteChangesPerBatchUseInprocLoaderValidateValidateInterval
对于队列读取器代理(agent_type = 9如果已在配置文件中定义),可以更改以下属性:
HistoryVerboseLevelLoginTimeoutOutputOutputVerboseLevelPollingIntervalQueryTimeoutResolverStateSQLQueueMode
若要查看为给定配置文件定义的参数,请运行 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_value 为 nvarchar(255),没有默认值。
返回代码值
0(成功)或 1(失败)。
注解
sp_change_agent_parameter 用于所有类型的复制。
权限
只有 sysadmin 固定服务器角色的成员才能执行sp_change_agent_parameter。