Replication Agent Profiles

 

Applies To: SQL Server 2016

When replication is configured, a set of agent profiles is installed on the Distributor. An agent profile contains a set of parameters that are used each time an agent runs: each agent logs in to the Distributor during its startup process and queries for the parameters in its profile. For merge subscriptions that use Web synchronization, profiles are downloaded and stored at the Subscriber. If the profile is changed, the profile at the Subscriber is updated the next time the Merge Agent runs. For more information about Web synchronization, see Web Synchronization for Merge Replication.

Replication provides a default profile for each agent and additional predefined profiles for the Log Reader Agent, Distribution Agent, and Merge Agent. In addition to the profiles provided, you can create profiles suited to your application requirements. An agent profile allows you to change key parameters easily for all agents associated with that profile. For example, if you have 20 Snapshot Agents and need to change the query timeout value (the -QueryTimeout parameter), you can update the profile used by the Snapshot Agents and all agents of that type will begin using the new value automatically the next time they run.

You might also have different profiles for different instances of an agent. For example, a Merge Agent that connects to the Publisher and Distributor over a dialup connection could use a set of parameters that are better suited to the slower communications link by using the slow link profile.

System_CAPS_ICON_note.jpg Note


If you specify a value for an agent parameter on the command line, that value overrides the value set for the same parameter in the agent profile.

To use and modify agent profiles

The following table shows the parameters defined in the default profile for the Snapshot Agent. For more information on these parameters, see Replication Snapshot Agent.

default
-BcpBatchSize100000
-HistoryVerboseLevel2
-LoginTimeout15
-QueryTimeout1800

The following table shows the parameters defined in the profiles for the Log Reader Agent. Each column in the table represents a named profile. For more information on these parameters, see Replication Log Reader Agent.

defaultverbose history
-HistoryVerboseLevel12
-LoginTimeout1515
-LogScanThreshold500000500000
-PollingInterval55
-QueryTimeout18001800
-ReadBatchSize500500

The following table shows the parameters defined in the profiles for the Distribution Agent. Each column in the table represents a named profile. For more information on these parameters, see Replication Distribution Agent.

defaultverbose historyWindows Synchronization ManagerContinue on data consistency errorsDistribution Profile for OLEDB streaming
-BcpBatchSize10000010000010001000002147473647
-CommitBatchSize100100100100100
-CommitBatchThreshold10001000100010001000
-HistoryVerboseLevel12111
-KeepAliveMessageInterval300300300300300
-LoginTimeout1515151515
-MaxBcpThreads11111
-MaxDeliveredTransactions00000
-OledbStreamThresholdNULLNULLNULLNULL32768
-PacketSizeNULLNULLNULLNULL32768
-PollingInterval55555
-QueryTimeout18001800180018001800
-SkipErrorsNULLNULLNULL-SkipErrors 2601:2627:20598NULL
-TransactionsPerHistory100100100100100
-UseOledbStreamingNULLNULLNULLNULL-UseOledbStreaming

The following table shows the parameters defined in the profiles for the Merge Agent. Each column in the table represents a named profile. For more information on these parameters, see Replication Merge Agent.

defaultverbose historyWindows Synchronization Managerrowcount validationrowcount and checksum validationslow linkhigh volume server-to-server
-BcpBatchSize1000001000001000100000100000100000100000
-ChangesPerHistory10050501001001001000
-DestThreads2111114
-DownloadGenerationsPerBatch50505050501500
-DownloadReadChangesPerBatch100100100100100100100
-DownloadWriteChangesPerBatch100100100100100100100
-FastRowCount1111111
-HistoryVerboseLevel2311212
-KeepAliveMessageInterval300300300300300300300
-LoginTimeout15151515151515
-MaxDownloadChanges0000000
-MaxUploadChanges0000000
-MetadataRetentionCleanup1111111
-NumDeadlockRetries5555555
-ParallelUploadDownloadNULLNULLNULLNULLNULLNULL1
-PollingInterval60606060606060
-QueryTimeout300300300300300300600
-QueueSizeMultiplierNULLNULLNULLNULLNULLNULL5
-SrcThreads2222213
-StartQueueTimeout0000000
-UploadGenerationsPerBatch50505050501500
-UploadReadChangesPerBatch100100100100100100100
-UploadWriteChangesPerBatch100100100100100100100
-Validate0001300
-ValidateInterval60606060606060

The following table shows the parameters defined in the default profile for the Queue Reader Agent. For more information on these parameters, see Replication Queue Reader Agent.

default
-HistoryVerboseLevel1
-LoginTimeout15
-PollingInterval5
-QueryTimeout1800

Replication Agent Administration
View and Modify Replication Agent Command Prompt Parameters (SQL Server Management Studio)
Replication Agent Executables Concepts

Community Additions

ADD
Show: