Replication Agent Profiles
Applies to:
SQL Server
Azure SQL Managed Instance
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.
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
Snapshot 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 | |
---|---|
-BcpBatchSize | 100000 |
-HistoryVerboseLevel | 2 |
-LoginTimeout | 15 |
-QueryTimeout | 1800 |
Log Reader Agent Profiles
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.
default | verbose history | |
---|---|---|
-HistoryVerboseLevel | 1 | 2 |
-LoginTimeout | 15 | 15 |
-LogScanThreshold | 500000 | 500000 |
-PollingInterval | 5 | 5 |
-QueryTimeout | 1800 | 1800 |
-ReadBatchSize | 500 | 500 |
Distribution Agent Profiles
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.
default | verbose history | Windows Synchronization Manager | Continue on data consistency errors | Distribution Profile for OLEDB streaming | |
---|---|---|---|---|---|
-BcpBatchSize | 100000 | 100000 | 1000 | 100000 | 2147473647 |
-CommitBatchSize | 100 | 100 | 100 | 100 | 100 |
-CommitBatchThreshold | 1000 | 1000 | 1000 | 1000 | 1000 |
-HistoryVerboseLevel | 1 | 2 | 1 | 1 | 1 |
-KeepAliveMessageInterval | 300 | 300 | 300 | 300 | 300 |
-LoginTimeout | 15 | 15 | 15 | 15 | 15 |
-MaxBcpThreads | 1 | 1 | 1 | 1 | 1 |
-MaxDeliveredTransactions | 0 | 0 | 0 | 0 | 0 |
-OledbStreamThreshold | NULL | NULL | NULL | NULL | 32768 |
-PacketSize | NULL | NULL | NULL | NULL | 32768 |
-PollingInterval | 5 | 5 | 5 | 5 | 5 |
-QueryTimeout | 1800 | 1800 | 1800 | 1800 | 1800 |
-SkipErrors | NULL | NULL | NULL | -SkipErrors 2601:2627:20598 | NULL |
-TransactionsPerHistory | 100 | 100 | 100 | 100 | 100 |
-UseOledbStreaming | NULL | NULL | NULL | NULL | -UseOledbStreaming |
Merge Agent Profiles
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.
default | verbose history | Windows Synchronization Manager | rowcount validation | rowcount and checksum validation | slow link | high volume server-to-server | |
---|---|---|---|---|---|---|---|
-BcpBatchSize | 100000 | 100000 | 1000 | 100000 | 100000 | 100000 | 100000 |
-ChangesPerHistory | 100 | 50 | 50 | 100 | 100 | 100 | 1000 |
-DestThreads | 2 | 1 | 1 | 1 | 1 | 1 | 4 |
-DownloadGenerationsPerBatch | 50 | 50 | 50 | 50 | 50 | 1 | 500 |
-DownloadReadChangesPerBatch | 100 | 100 | 100 | 100 | 100 | 100 | 100 |
-DownloadWriteChangesPerBatch | 100 | 100 | 100 | 100 | 100 | 100 | 100 |
-FastRowCount | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
-HistoryVerboseLevel | 2 | 3 | 1 | 1 | 2 | 1 | 2 |
-KeepAliveMessageInterval | 300 | 300 | 300 | 300 | 300 | 300 | 300 |
-LoginTimeout | 15 | 15 | 15 | 15 | 15 | 15 | 15 |
-MaxDownloadChanges | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
-MaxUploadChanges | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
-MetadataRetentionCleanup | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
-NumDeadlockRetries | 5 | 5 | 5 | 5 | 5 | 5 | 5 |
-ParallelUploadDownload | NULL | NULL | NULL | NULL | NULL | NULL | 1 |
-PollingInterval | 60 | 60 | 60 | 60 | 60 | 60 | 60 |
-QueryTimeout | 300 | 300 | 300 | 300 | 300 | 300 | 600 |
-QueueSizeMultiplier | NULL | NULL | NULL | NULL | NULL | NULL | 5 |
-SrcThreads | 2 | 2 | 2 | 2 | 2 | 1 | 3 |
-StartQueueTimeout | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
-UploadGenerationsPerBatch | 50 | 50 | 50 | 50 | 50 | 1 | 500 |
-UploadReadChangesPerBatch | 100 | 100 | 100 | 100 | 100 | 100 | 100 |
-UploadWriteChangesPerBatch | 100 | 100 | 100 | 100 | 100 | 100 | 100 |
-Validate | 0 | 0 | 0 | 1 | 3 | 0 | 0 |
-ValidateInterval | 60 | 60 | 60 | 60 | 60 | 60 | 60 |
Queue Reader Agent Profiles
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 | |
---|---|
-HistoryVerboseLevel | 1 |
-LoginTimeout | 15 |
-PollingInterval | 5 |
-QueryTimeout | 1800 |
See Also
Replication Agent Administration
View and Modify Replication Agent Command Prompt Parameters (SQL Server Management Studio)
Replication Agent Executables Concepts