DistributionDatabase 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 DistributionDatabase object represents a database located at the Distributor used to store replication information. A Distributor can have multiple distribution databases.

SQL-DMO object model that shows the current object

With the DistributionDatabase object, you can:

  • Create a new distribution database.

  • Change the properties of an existing distribution database.

To add a distribution database to the Distributor

  1. Create a new DistributionDatabase object.

  2. Set the Name property to the name of the new distribution database.

  3. Set the SecurityMode property as appropriate.

  4. If the SecurityMode property is set to SQLDMOSecurity_Normal, set the StandardLogin and StandardPassword properties as appropriate.

  5. Add the DistributionDatabase object to the DistributionDatabases collection of a connected Distributor object.

To alter an existing distribution database

  1. Get a DistributionDatabase object from the DistributionDatabases collection of a connected Distributor object.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the DistributionDatabase properties to reflect the changes to the distribution database.

  4. Use the DoAlter method to submit the changes to Microsoft SQL Server.


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

Community Additions