sp_change_agent_parameter (Transact-SQL)
更改存储在MSagent_parameters系统表中的副本 (replica)代理配置文件的参数。 此存储过程可在运行代理的分发服务器的任意数据库中执行。
语法
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)
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈