sp_changedistributiondb (Transact-SQL)

適用対象: SQL ServerAzure SQL Managed Instance

ディストリビューション データベースのプロパティを変更します。 このストアド プロシージャは、任意のデータベースのディストリビューターで実行されます。

Transact-SQL 構文表記規則

構文

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

引数

[ @database = ] 'database' ディストリビューション データベースの名前を指定します。 データベース は sysname で、既定値はありません。

[ @property = ] 'property' 指定されたデータベースに対して変更するプロパティです。 プロパティ は sysname であり、次のいずれかの値を指定できます。

Value	説明
history_retention	履歴テーブルの保持期間です。
max_distretention	ディストリビューションの最大保有期間。
min_distretention	ディストリビューションの最小保有期間。
NULL (既定値)	使用可能 なすべてのプロパティ 値が出力されます。

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

アクセス許可

sp_changedistributiondbを実行できるのは、sysadmin 固定サーバー ロールのメンバーだけです。

参照

View and Modify Distributor and Publisher Properties (ディストリビューターとパブリッシャーのプロパティの表示および変更)
sp_adddistributiondb (Transact-SQL)
sp_dropdistributiondb (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
レプリケーション ストアド プロシージャ (Transact-SQL)