sp_change_agent_parameter (Transact-SQL)
適用於:SQL ServerAzure SQL 受控執行個體
變更儲存在MSagent_parameters系統數據表中的複寫代理程式配置檔參數。 此預存程式會在代理程序執行所在的散發者端,在任何資料庫上執行。
語法
sp_change_agent_parameter [ @profile_id= ] profile_id, [ @parameter_name= ] 'parameter_name', [ @parameter_value= ] 'parameter_value'
引數
[ @profile_id = ] profile_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),如果在配置檔中定義,則可以變更下列屬性:
70 訂閱者
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用於所有類型的複寫。
權限
只有系統管理員固定伺服器角色的成員才能執行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 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應