DistributionDatabase.HistoryRetention プロパティ

レプリケーション エージェントの履歴データを保持する時間の長さ (時間) を取得します。値の設定も可能です。

名前空間:  Microsoft.SqlServer.Replication
アセンブリ:  Microsoft.SqlServer.Rmo (Microsoft.SqlServer.Rmo.dll)

構文

'宣言
Public Property HistoryRetention As Integer 
    Get 
    Set
'使用
Dim instance As DistributionDatabase 
Dim value As Integer 

value = instance.HistoryRetention

instance.HistoryRetention = value
public int HistoryRetention { get; set; }
public:
property int HistoryRetention {
    int get ();
    void set (int value);
}
member HistoryRetention : int with get, set
function get HistoryRetention () : int 
function set HistoryRetention (value : int)

プロパティ値

型: System.Int32
Int32 値です。

説明

HistoryRetention プロパティを取得できるのは、ディストリビューション データベースの固定データベース ロール db_owner または replmonitor のメンバー、ディストリビューション データベースを使用しているパブリケーションのパブリケーション アクセス リスト (PAL) のユーザー、またはディストリビューション データベースの MSdistributiondbs システム テーブルに対する SELECT 権限を持つユーザーだけです。

HistoryRetention プロパティを設定できるのは、ディストリビューター側の固定サーバー ロール sysadmin のメンバーだけです。

HistoryRetention プロパティを取得すると、sp_helpdistributiondb を実行したのと同じことになります。

HistoryRetention プロパティを設定すると、sp_adddistributiondb または sp_changedistributiondb を実行したのと同じことになります。

使用例

          // Set the server and database names
            string distributionDbName = "distribution";
            string publisherName = publisherInstance;
            string publicationDbName = "AdventureWorks2012";

            DistributionDatabase distributionDb;
            ReplicationServer distributor;
            DistributionPublisher publisher;
            ReplicationDatabase publicationDb;

            // Create a connection to the server using Windows Authentication.
            ServerConnection conn = new ServerConnection(publisherName);

            try
            {
                // Connect to the server acting as the Distributor 
                // and local Publisher.
                conn.Connect();

                // Define the distribution database at the Distributor,
                // but do not create it now.
                distributionDb = new DistributionDatabase(distributionDbName, conn);
                distributionDb.MaxDistributionRetention = 96;
                distributionDb.HistoryRetention = 120;

                // Set the Distributor properties and install the Distributor.
                // This also creates the specified distribution database.
                distributor = new ReplicationServer(conn);
                distributor.InstallDistributor((string)null, distributionDb);

                // Set the Publisher properties and install the Publisher.
                publisher = new DistributionPublisher(publisherName, conn);
                publisher.DistributionDatabase = distributionDb.Name;
                publisher.WorkingDirectory = @"\\" + publisherName + @"\repldata";
                publisher.PublisherSecurity.WindowsAuthentication = true;
                publisher.Create();

                // Enable AdventureWorks2012 as a publication database.
                publicationDb = new ReplicationDatabase(publicationDbName, conn);

                publicationDb.EnabledTransPublishing = true;
                publicationDb.EnabledMergePublishing = true;
            }
            catch (Exception ex)
            {
                // Implement appropriate error handling here.
                throw new ApplicationException("An error occured when installing distribution and publishing.", ex);
            }
            finally
            {
                conn.Disconnect();
            }
' Set the server and database names
Dim distributionDbName As String = "distribution"
Dim publisherName As String = publisherInstance
Dim publicationDbName As String = "AdventureWorks2012"

Dim distributionDb As DistributionDatabase
Dim distributor As ReplicationServer
Dim publisher As DistributionPublisher
Dim publicationDb As ReplicationDatabase

' Create a connection to the server using Windows Authentication.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the server acting as the Distributor 
    ' and local Publisher.
    conn.Connect()

    ' Define the distribution database at the Distributor,
    ' but do not create it now.
    distributionDb = New DistributionDatabase(distributionDbName, conn)
    distributionDb.MaxDistributionRetention = 96
    distributionDb.HistoryRetention = 120

    ' Set the Distributor properties and install the Distributor.
    ' This also creates the specified distribution database.
    distributor = New ReplicationServer(conn)
    distributor.InstallDistributor((CType(Nothing, String)), distributionDb)

    ' Set the Publisher properties and install the Publisher.
    publisher = New DistributionPublisher(publisherName, conn)
    publisher.DistributionDatabase = distributionDb.Name
    publisher.WorkingDirectory = "\\" + publisherName + "\repldata"
    publisher.PublisherSecurity.WindowsAuthentication = True
    publisher.Create()

    ' Enable AdventureWorks2012 as a publication database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    publicationDb.EnabledTransPublishing = True
    publicationDb.EnabledMergePublishing = True

Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("An error occured when installing distribution and publishing.", ex)

Finally
    conn.Disconnect()

End Try

関連項目

参照

DistributionDatabase クラス

Microsoft.SqlServer.Replication 名前空間

その他の技術情報

パブリッシングおよびディストリビューションを構成する方法 (RMO プログラミング)

パブリッシャーとディストリビューターのプロパティを表示および変更する方法 (RMO プログラミング)