DistributionDatabase クラス

[アーティクル]
02/01/2013

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

継承階層

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) のメンバーはすべて、スレッドセーフです。インスタンスメンバーの場合は、スレッドセーフであるとは限りません。

次の方法で共有

DistributionDatabase クラス

継承階層

構文

コンストラクター

プロパティ

メソッド

説明

スレッドセーフ

使用例

スレッドセーフ

関連項目

参照

その他の技術情報

その他のリソース

次の方法で共有

DistributionDatabase クラス

継承階層

構文

コンストラクター

プロパティ

メソッド

説明

スレッド セーフ

使用例

スレッド セーフ

関連項目

参照

その他の技術情報

その他のリソース

スレッドセーフ

スレッドセーフ