sp_change_agent_parameter (Transact-SQL)
适用于: 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
),如果在配置文件中定义,可以更改以下属性:
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_id
sp_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
。