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

Properties

AgentsStatus Property

LogFileSize Property

DataFile Property

LogFolder Property

DataFileSize Property

MaxDistributionRetention Property

DataFolder Property

MinDistributionRetention Property

DistributionCleanupTaskName Property

Name Property

HistoryCleanupTaskName Property

SecurityMode Property (DistributionDatabase, IntegratedSecurity)

HistoryRetention Property

StandardLogin Property

LogFile Property

StandardPassword Property

Methods

BeginAlter Method

Refresh Method

CancelAlter Method

Remove Method (Objects)

DoAlter Method

Script Method (Replication Objects)

Remarks

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.

Note

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.

See Also

Reference

DistributionDatabase2 Object

Help and Information

Getting SQL Server 2005 Assistance