Performing Atomic Bulk Materialization

Learn to perform atomic bulk materialization.

1. Use isql to log in to the replicate Replication Server as the system administrator (sa):

   isql -Usa -Psa_password -SRRS_servername

   where:

   • sa is the system administrator user ID.

   • sa_password is the password for the system administrator user ID.

   • RRS_servername is the server name of the replicate Replication Server.

2. At the replicate Replication Server, define the subscription:

   1> define subscription subscription_name
   2> for replication_definition
   3> with replicate at dataserver.database
   4> [where search_conditions]
   5> go 

   The dataserver.database must match the Replication Server connection name you use for the replicate database.

3. Check the subscription at both the primary and replicate Replication Servers. To verify that the subscription status is DEFINED, enter:

   1> check subscription subscription_name
   2> for replication_definition
   3> with replicate at dataserver.database
   4> go

4. Lock the primary table to prevent primary transaction activity. This prevents updates to the primary table during materialization.
5. Unload the subscription data at the primary site using your site’s preferred database unload method to select or dump the data from the primary table.
   Note: When unloading subscription data from the primary table, make sure you select only the columns specified in the replication definition and the rows specified in the subscription.
6. Perform any datatype translations necessary for the subscription data.

   If any column-level translation is specified in the replication definition for this data, perform the datatype translation specified in the replication definition.

   If class-level translations are specified for the subscription, perform the datatype translations specified for the subscription.

7. At the replicate Replication Server, activate the subscription:

   1> activate subscription subscription_name
   2> for replication_definition
   3> with replicate at dataserver.database
   4> with suspension
   5> go

8. Wait for the subscription to become active at both the primary and replicate Replication Servers. Execute check subscription at both the primary and replicate Replication Servers to verify that the subscription status is ACTIVE.

   When the subscription status is ACTIVE at the replicate Replication Server, the database connection for the replicate database is suspended.

9. Restore the primary table to read-write access (unlock).
10. Use the bcp or your site’s preferred database utility to load the subscription data into the replicate database.
11. From the replicate Replication Server, resume the database connection for the replicate database:

    1> resume connection
    2> to dataserver.database
    3> go 

12. Validate the subscription at the replicate Replication Server:

    1> validate subscription subscription_name
    2> for replication_definition
    3> with replicate at dataserver.database
    4> go

13. Wait for the subscription to become valid at both the primary and replicate Replication Servers, then execute check subscription at both the primary and replicate Replication Servers to verify that the status is VALID.