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 から継承されています。)

先頭に戻る

メソッド

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

先頭に戻る

説明

この名前空間、クラス、またはメンバは、.NET Framework 2.0 でのみサポートされています。

スレッド セーフ

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

使用例

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

            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 AdventureWorks 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 = "AdventureWorks2008R2"

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 AdventureWorks 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 プログラミング)