Agent Profiles
Replication agent profiles specify the values of various parameters that you can supply with each execution of the agent. Each agent has numerous options that you can use to fine-tune the agent’s behavior. This section highlights only those options that are new to SQL Server 2005 or have changed since the previous versions of the software.
To view parameters used by a given replication agent’s profile, right-click the agent, choose Agent Profile and click the ellipsis button next to the profile in the resulting dialog box shown in the following screenshot.
You cannot change the parameters used by the built-in profiles. Instead, click New to create a new profile; SQL Server will ask you to choose the built-in profile used for initializing the parameter values for the new profile. For example, if you’re creating a new log reader agent profile, you can choose to initialize its parameters from the default agent profile or verbose history agent profile. The dialog box for tweaking profile parameters is shown next. Note the checkbox near the bottom of the dialog box: Show Only Parameters Used In This Profile. This option is particularly handy if you want to modify only a couple of parameters and not have to scroll through dozens of others. You can also sort the parameters by parameter name, default value, or current value by simply clicking on each column.
The following table summarizes replication agent parameters that are new in SQL Server 2005 and those that have changed since previous versions.
Agent |
Parameter |
Description/Note |
New in SQL Server 2005 |
Default Value |
Snapshot, Log Reader, Distribution, Queue Reader |
Encryption Level |
Replication doesn’t encrypt data going from publisher to subscribers; however SQL Server 2005 can be configured to use SSL for encrypting the data sent across network. Details of SSL configuration are beyond the scope of this article, but you can exploit the SQL Server 2005 Network Configuration page within SQL Server Configuration Manager for this purpose. The Encryption Level parameter signifies the level of encryption used by the agent and can take the following values: 0: SSL isn’t used. 1: SSL is used, but the agent doesn’t verify that the certificate is signed by a trusted issuer. 2: SSL is used, and the certificate is verified. |
Y |
0 |
Distribution |
OLEDB Stream Threshold |
This parameter is relevant only if you turn on OLEDB streaming option for binary large objects. This parameter specifies the minimum size for the data for which OLEDB streaming will be used. |
Y |
32768 |
Distribution |
Use In Proc Loader |
Forces the agent to use the BULK INSERT command when applying snapshots. This option can boost the performance of snapshot delivery. Keep in mind, however, that this parameter is incompatible with XML data type. |
Y |
0 |
Distribution |
Use OLEDB Streaming |
Enables binding of binary large object data as a stream. The value of 1 means that OLEDB streaming is enabled; 0 signifies that this option is not enabled. |
Y |
0 |
Snapshot |
70 Subscribers |
This parameter is required if any of the subscribers are using SQL Server version 7.0. |
Y |
0 |
Snapshot |
Max Network Optimization |
This parameter is only relevant for merge replication and is used to reduce the likelihood of executing unnecessary commands on the subscriber. |
Y |
0 |
Snapshot, Log Reader, Queue Reader |
Publisher Failover Partner |
If you use database mirroring, this parameter specifies the server name\instance name of the database mirroring partner for the publisher. |
Y |
None |
Snapshot |
Start Queue Timeout |
Maximum number of seconds the agent will wait if concurrent dynamic snapshots are running. This parameter is relevant only for merge publications. |
Y |
0 |
Snapshot, Log Reader, Distribution, Queue Reader |
Query Timeout |
Number of seconds before the agent will fail because of query timeout. The default value has been increased from 300 to 1800 seconds. |
N |
1800 |
Log Reader, Snapshot, Distribution, Queue Reader |
Output |
Although this parameter was available with previous versions, you couldn’t specify it through the graphical user interface of agent profiles. |
N |
None |
Log Reader, Snapshot, Distribution, Queue Reader |
Output Verbose Level |
Although this parameter was available with previous versions, you couldn’t specify it through the graphical user interface of agent profiles. |
N |
0 |
Log Reader |
Read Batch Threshold |
Number of commands to be read from the transaction log in a single batch before forwarding these commands to the subscriber. This parameter isn’t new, but the default value is 0 (it advises SQL Server to read all replicated commands in the transaction log) instead of 100. |
N |
0 |
Log Reader |
Recover from Data Errors |
Advises SQL Server to continue replicating from an Oracle publisher even if an error is encountered at the column-level data. If this parameter has a default value of 0, such errors would cause the log reader agent to stop. A value of 1 will replicate NULL for columns that encounter errors. |
Y |
0 |
Log Reader, Queue Reader |
Polling Interval |
Determines the frequency used for polling the transaction log of the publisher. The default value has been changed to 5 seconds; in previous versions it was 10 seconds. |
N |
5 |
Snapshot |
HRBCPDynamicBlocks |
Specific to Oracle publications, this option controls whether Bulk Copy Program (BCP) data blocks can grow dynamically. |
Y |
None |
Snapshot |
HRBCPBlockSize |
Specific to Oracle publications this parameter specifies BCP block size in kilobytes. |
Y |
64 |
Snapshot |
HRBCPBlocks |
Specific to Oracle publications, this parameter manages the number of BCP blocks queued between reader and writer threads. |
Y |
50 |
Distribution |
Subscription Streams |
Governs the number of processes that can connect to a subscriber and deliver replicated commands in parallel. Maximum is 64. Supported only for subscribers running SQL Server 2005. For previous versions, this parameter is ignored. |
Y |
0 |
Distribution |
Use DTS |
Required if a publication allows transforming data before it is delivered to subscribers. |
Y |
None |
Snapshot |
Publisher Deadlock Priority |
Optionally assigns a deadlock priority to the connection generating the snapshot on the publisher. By default, priority is not assigned. The value of 1 grants snapshot connection a higher priority than other applications. The value of (-1) assigns the snapshot connection a lower priority than other applications. |
Y |
0 |