The first step in programming replication is to define the replication topology for your application. If you are writing an application that will use an existing replication topology, such as a client application that accesses data at an existing subscriber, you should move onto the next step.

Note:
In some cases, deploying the replication topology will be the sole purpose of the application.

The replication topology that you define depends on many factors, including the following:

• Whether or not replicated data needs to be updated, and by whom.
  
• Your data distribution needs regarding consistency, autonomy, and latency.
  
• The replication environment, including business users, technical infrastructure, network and security, and data characteristics.
  
• The types of replication and replication options.
  
• The replication topologies and how they align with the types of replication.
  

For more information about designing a replication topology that best satisfies the needs of your business, see Solution Design Considerations (Replication). If you are new to Microsoft SQL Server replication, see Overview (Replication).

Once the replication topology has been defined, you should decide on the functionalities that your application will offer. These functionalities can range from a script that synchronizes a subscription to an application with a user interface to configure replication. Replication supports the following general programming tasks:

• Setting up replication.
  
• Synchronizing Subscribers.
  
• Maintaining a replication topology.
  
• Monitoring a replication topology.
  
• Troubleshooting replication.
  

It is also common extend your application by combining replication functionalities with other functionalities provided by SQL Server. The following table highlights some extended functionalities that you might provide in your replication application.

Security is important in any application, and planning for security should be completed before writing any code. Application security can be divided into three main parts: securing the database, securing replication, and writing secure code.

The following topics provide information on security:

• Security and Protection (Replication)
  
• Security and Protection (Database Engine)
  

When developing a replication application, there are three basic development environments to consider. Each development environment has access to the same replication functionalities with some exceptions. Replication applications can be developed in each of the following environments.

• Managed code
  Object oriented development environment that leverages the benefits of the .NET Framework programming and the .NET common language runtime (CLR). Managed code is the recommended programming environment for both .NET development and SQL Server applications. Managed replication interfaces enable the programming of replication administration in an object-oriented manner without having to know Transact-SQL, and it also provides some callback functionalities when running replication agents that are not available from scripts. Managed code is the best environment for developing reusable components and user interface applications.
  
• Scripting
  Simple applications that execute a series of commands as either replication system stored procedures in Transact-SQL scripts or commands in batch files. While you can execute scripts in a managed environment using the SQL Server in-process managed provider, the same functionality can obtained by using managed replication interfaces, which also provide callback functionalities. Scripting is the best environment for executing tasks that will run only a few times and where callback functionalities are not required, such as installing a replication server.
  
• Native code
  Object-oriented development environment that utilizes direct access to the system or COM objects such that code is not managed by the CLR. Native code replication interfaces are deprecated or discontinued. For more information, see Deprecated Features in SQL Server Replication or Discontinued Functionality in SQL Server Replication.
  

The final planning step is choosing the appropriate replication programming interface that implements the desired replication functionality for the chosen development environment. The following table shows the replication programming interfaces available.

At Adventure Works, data needs to be published for 200 sales representatives around the world. The sales representatives travel often and will need to use laptop computers or personal digital assistants (PDAs) to change customer data and add new orders. The changes will then need to be synchronized with the Publisher when the sales representative connects the laptop to the network.

For this application, the planning steps might look like the following:

1. The replication topology for this application already exists. However, a new pull subscription must be created at the client. The publication should use parameterized filters to replicate a unique set of data to each sales representative.
   
2. In addition to the typical data access required for a sales application, this application should enable a salesperson to synchronize the pull subscription on demand by clicking a button. Since a sales representative will install and run the application, it also needs to be able to configure a subscription and apply the initial snapshot at the client. Optionally, the application will use the infrastructure provided by Windows for sensing wireless connectivity to automatically synchronize the subscription when a connection is detected.
   
3. Follow all of the security guidelines for replication, including using Windows Authentication and a virtual private network (VPN) when connecting to the publisher. If implementing Web synchronization, use a secure sockets layer (SSL) connection. For more information, see Configuring Web Synchronization.
   
4. In order to take advantage of the features of the .NET Framework, the application is developed using a managed code language.
   
5. Based on these requirements, the Replication Management Objects (RMO) managed interface can provide all of the needed replication functionality for this application.
   

This example scenario has been implemented in a sample application that ships with SQL Server. For more information, see Sales Orders Sample Scenario.

Concepts

Help and Information