sp_changedistributiondb (Transact-SQL)

更改分发数据库的属性。 此存储过程在分发服务器的任何数据库中执行。

主题链接图标Transact-SQL 语法约定

语法

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

参数

  • [ @database=] 'database'
    分发数据库的名称。database 的数据类型为 sysname,没有默认值。

  • [ @property=] 'property'
    要更改的给定数据库的属性。property 的数据类型为 sysname,可以是下列值之一。

    说明

    history_retention

    历史记录表保持期。

    max_distretention

    最大分发保持期。

    min_distretention

    最小分发保持期。

    NULL(默认值)

    打印所有可用的 property 值。

  • [ @value=] 'value'
    指定属性的新值。value 的数据类型为 nvarchar(255),默认值为 NULL。

返回代码值

0(成功)或 1(失败)

注释

sp_changedistributiondb 用于所有类型的复制。

示例

DECLARE @distributionDB AS sysname;
SET @distributionDB = N'distribution';

-- Change the history retention period to 24 hours and the
-- maximum retention period to 48 hours.  
USE distribution
EXEC sp_changedistributiondb @distributionDB, N'history_retention', 24
EXEC sp_changedistributiondb @distributionDB, N'max_distretention', 48
GO 

权限

只有 sysadmin 固定服务器角色成员才能执行 sp_changedistributiondb