• Article

DistributionSubscription Object

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The DistributionSubscription object exposes the properties of subscription to a publication maintained by a Distributor.

SQL-DMO object model that shows the current object

Remarks

For snapshot and transactional replication, a replication Distributor maintains an image of articles defining a publication. The Distributor replicates the articles to Subscribers that enable one type of replication load balancing.

There is no requirement that an instance of Microsoft SQL Server create Distributor-maintained data images. Snapshot and transactional replication publications created on the Distributor enable one type of third-party, or heterogeneous, replication.

With the DistributionSubscription object, you can:

  • Create a Distributor-originated (push) subscription to a heterogeneous replication publication.

  • Enable or disable a subscription to a publication maintained by the Distributor.

  • Remove a push subscription to a heterogeneous replication publication.

Note

DistributionSubscription object properties are read/write only when the object is being used to create a subscription. When a DistributionSubscription object references a Distributor's image of an existing subscription, all properties are read-only.

The DistributionSubscription object is compatible with instances of SQL Server versions 7.0 and later. However, the DistributionSubscription2 object extends the functionality of the DistributionSubscription object for use with features that were introduced in SQL Server 2000.