sp_change_agent_parameter （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

變更儲存在MSagent_parameters系統數據表中的複寫代理程式配置檔參數。 此預存程式會在代理程序執行所在的散發者端，在任何資料庫上執行。

Transact-SQL 語法慣例

語法

  
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)