DistributionDatabase クラス

ディストリビューター側のディストリビューション データベースを表します。

継承階層

System.Object
  Microsoft.SqlServer.Replication.ReplicationObject
    Microsoft.SqlServer.Replication.DistributionDatabase

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

構文

'宣言
Public NotInheritable Class DistributionDatabase _
    Inherits ReplicationObject
'使用
Dim instance As DistributionDatabase
public sealed class DistributionDatabase : ReplicationObject
public ref class DistributionDatabase sealed : public ReplicationObject
[<SealedAttribute>]
type DistributionDatabase =  
    class 
        inherit ReplicationObject 
    end
public final class DistributionDatabase extends ReplicationObject

DistributionDatabase 型は、以下のメンバーを公開しています。

コンストラクター

  名前 説明
パブリック メソッド DistributionDatabase() DistributionDatabase クラスの新しいインスタンスを作成します。
パブリック メソッド DistributionDatabase(String, ServerConnection) 指定したデータベース名およびディストリビューターへの接続を使用して、DistributionDatabase クラスの新しいインスタンスを作成します。

先頭に戻る

プロパティ

  名前 説明
パブリック プロパティ CachePropertyChanges レプリケーション プロパティに加えられた変更をキャッシュするか、またはすぐに適用するかを取得します。値の設定も可能です。 (ReplicationObject から継承されています。)
パブリック プロパティ ConnectionContext Microsoft SQL Server のインスタンスへの接続を取得します。値の設定も可能です。 (ReplicationObject から継承されています。)
パブリック プロパティ DataFile ディストリビューション データベースのデータ ファイルの名前を取得します。値の設定も可能です。
パブリック プロパティ DataFileSize ディストリビューション データベースのプライマリ データベース ファイルのサイズを取得します。値の設定も可能です。
パブリック プロパティ DataFolder ディストリビューション データベースのデータ ファイルが含まれるディレクトリへのパスを取得します。値の設定も可能です。
パブリック プロパティ DistributionCleanupTaskName ディストリビューションでのレプリケーション テーブルのクリーンアップを行う SQL Server エージェント ジョブの名前を取得します。
パブリック プロパティ DistributorSecurity ディストリビューション データベースを作成するディストリビューターへの接続に使用されるセキュリティ コンテキストを取得します。
パブリック プロパティ HistoryCleanupTaskName レプリケーション履歴テーブルのクリーンアップを行う SQL Server エージェント ジョブの名前を取得します。
パブリック プロパティ HistoryRetention レプリケーション エージェントの履歴データを保持する時間の長さ (時間) を取得します。値の設定も可能です。
パブリック プロパティ IsExistingObject サーバーにオブジェクトが存在するかどうかを取得します。 (ReplicationObject から継承されています。)
パブリック プロパティ LogFile データベース トランザクション ログ レコードを保持するファイルの名前を取得します。値の設定も可能です。
パブリック プロパティ LogFileSize データベース トランザクション ログ レコードを保持するファイルのサイズを取得します。値の設定も可能です。
パブリック プロパティ LogFolder データベース トランザクション ログ レコードを保持するファイルが存在するディレクトリへのパスを取得します。値の設定も可能です。
パブリック プロパティ MaxDistributionRetention トランザクションがディストリビューション データベースから削除されるまでの最大保有期間 (時間) を取得します。値の設定も可能です。
パブリック プロパティ MinDistributionRetention トランザクションがディストリビューション データベースから削除されるまでの最小保有期間 (時間) を取得します。値の設定も可能です。
パブリック プロパティ Name ディストリビューション データベースの名前を取得します。値の設定も可能です。
パブリック プロパティ QueueReaderAgentExists このディストリビューション データベースに対してキュー リーダー エージェント ジョブが作成されているかどうかを取得します。値の設定も可能です。
パブリック プロパティ QueueReaderAgentName このディストリビューション データベースに対して作成されているキュー リーダー エージェント ジョブの名前を取得します。値の設定も可能です。
パブリック プロパティ QueueReaderAgentProcessSecurity キュー リーダー エージェント ジョブを実行するためのエージェント プロセス セキュリティ コンテキストを取得します。
パブリック プロパティ SqlServerName このオブジェクトの接続先となる Microsoft SQL Server インスタンスの名前を取得します。 (ReplicationObject から継承されています。)
パブリック プロパティ UserData ユーザーが独自のデータをオブジェクトにアタッチすることを許可するオブジェクト プロパティを取得します。値の設定も可能です。 (ReplicationObject から継承されています。)

先頭に戻る

メソッド

  名前 説明
パブリック メソッド CleanUpAnonymousSubscription ディストリビューター側の匿名サブスクリプションのメタデータを削除します。
パブリック メソッド CommitPropertyChanges キャッシュされているすべてのプロパティ変更ステートメントを、Microsoft SQL Server のインスタンスに送信します。 (ReplicationObject から継承されています。)
パブリック メソッド Create ディストリビューション データベースを作成します。
パブリック メソッド CreateQueueReaderAgent ディストリビューション データベースにキュー リーダー エージェント ジョブを作成します。
パブリック メソッド Decouple 参照先のレプリケーション オブジェクトをサーバーから切断します。 (ReplicationObject から継承されています。)
パブリック メソッド Equals (Object から継承されています。)
パブリック メソッド GetHashCode (Object から継承されています。)
パブリック メソッド GetType (Object から継承されています。)
パブリック メソッド Load サーバーから既存のオブジェクトのプロパティを読み込みます。 (ReplicationObject から継承されています。)
パブリック メソッド LoadProperties サーバーから既存のオブジェクトのプロパティを読み込みます。 (ReplicationObject から継承されています。)
パブリック メソッド Refresh オブジェクトのプロパティを再度読み込みます。 (ReplicationObject から継承されています。)
パブリック メソッド RegisterBusinessLogicHandler ディストリビューターにビジネス ロジック ハンドラー アセンブリを登録します。
パブリック メソッド Remove ディストリビューション データベースを削除します。
パブリック メソッド Script オブジェクトが表すディストリビューション データベースを作成または削除するために使用できる Transact-SQL スクリプトを生成します。
パブリック メソッド ToString (Object から継承されています。)
パブリック メソッド UnregisterBusinessLogicHandler ディストリビューターから、ビジネス ロジック ハンドラーの登録を削除します。

先頭に戻る

説明

スレッド セーフ

この型の public static (Microsoft Visual Basic では Shared) のすべてのメンバーは、マルチスレッド操作で安全に使用できます。 インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

使用例

           // 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

スレッド セーフ

この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

関連項目

参照

Microsoft.SqlServer.Replication 名前空間

その他の技術情報

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

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