sp_changedistributiondb (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
ディストリビューション データベースのプロパティを変更します。 このストアド プロシージャは、任意のデータベースのディストリビューターで実行されます。
構文
sp_changedistributiondb
[ @database = ] N'database'
[ , [ @property = ] N'property' ]
[ , [ @value = ] N'value' ]
[ ; ]
引数
[ @database = ] N'database'
ディストリビューション データベースの名前。 @database は sysname で、既定値はありません。
[ @property = ] N'property'
指定されたデータベースに対して変更するプロパティ。 @property は sysname であり、これらの値のいずれかになります。
| 値 | 説明 |
|---|---|
history_retention |
履歴テーブルの保持期間です。 |
max_distretention |
ディストリビューションの最大保有期間。 |
min_distretention |
ディストリビューションの最小保有期間。 |
NULL (既定) |
使用可能なすべての @property 値が出力されます。 |
[ @value = ] N'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を実行できます。