sp-changedistributiondb-transact-sql.md

title	sp_changedistributiondb (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/03/2017
ms.prod	sql-server-2016
ms.reviewer
ms.suite
ms.technology	replication
ms.tgt_pltfrm
ms.topic	language-reference
applies_to	SQL Server
f1_keywords	sp_changedistributiondb_TSQL sp_changedistributiondb
helpviewer_keywords	sp_changedistributiondb
ms.assetid	66f73185-ea9e-43f9-86ed-9dd933cee2f6
caps.latest.revision	28
author	BYHAM
ms.author	rickbyh
manager	jhubbard

sp_changedistributiondb (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx_md]

Changes the properties of the distribution database. This stored procedure is executed at the Distributor on any database.

Transact-SQL Syntax Conventions

Syntax

  
sp_changedistributiondb [ @database= ] 'database'   
    [ , [ @property= ] 'property' ]   
    [ , [ @value= ] 'value' ]  

Arguments

[ @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.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_changedistributiondb is used in all types of replication.

Example

[!code-sqlHowTo#sp_changedistributiondb]

Permissions

Only members of the sysadmin fixed server role can execute sp_changedistributiondb.

See Also

View and Modify Distributor and Publisher Properties
sp_adddistributiondb (Transact-SQL)
sp_dropdistributiondb (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
Replication Stored Procedures (Transact-SQL)