適用於: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
配置文件的識別碼。 @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,接下來 sp_help_agent_parameters 使用 來執行 , profile_id 以查看與配置文件相關聯的參數。 您可以藉由執行 sp_add_agent_parameter,將參數新增至配置檔。
[ @parameter_value = ] N'parameter_value'
參數的新值。 @parameter_value為 nvarchar(255),沒有預設值。
傳回碼值
0 (成功) 或 1 (失敗)。
備註
sp_change_agent_parameter 用於所有類型的複寫。
權限
只有系統管理員固定伺服器角色的成員才能執行 sp_change_agent_parameter。