title | description | author | ms.author | ms.date | ms.service | ms.subservice | ms.topic | f1_keywords | helpviewer_keywords | dev_langs | ||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sp_changedistributiondb (Transact-SQL) |
sp_changedistributiondb (Transact-SQL) |
markingmyname |
maghan |
03/03/2017 |
sql |
replication |
reference |
|
|
|
[!INCLUDE SQL Server SQL MI]
Changes the properties of the distribution database. This stored procedure is executed at the Distributor on any database.
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions
sp_changedistributiondb [ @database= ] 'database'
[ , [ @property= ] 'property' ]
[ , [ @value= ] 'value' ]
[ @database = ] 'database'
Is the name of the distribution database. database is sysname, with no default.
[ @property = ] 'property'
Is the property to change for the given database. property is sysname, and can be one of these values.
Value | Description |
---|---|
history_retention | History table retention period. |
max_distretention | Maximum distribution retention period. |
min_distretention | Minimum distribution retention period. |
NULL (default) | All available property values are printed. |
[ @value = ] 'value'
Is the new value for the specified property. value is nvarchar(255), with a default of NULL.
0 (success) or 1 (failure)
sp_changedistributiondb is used in all types of replication.
:::code language="sql" source="../replication/codesnippet/tsql/sp-changedistributiondb-_1.sql":::
Only members of the sysadmin fixed server role can execute sp_changedistributiondb.
View and Modify Distributor and Publisher Properties
sp_adddistributiondb (Transact-SQL)
sp_dropdistributiondb (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
Replication Stored Procedures (Transact-SQL)