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
配置文件的識別碼。 @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。
相關內容
意見反映
即將推出：我們會在 2024 年淘汰 GitHub 問題，並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交及檢視以下的意見反映：