パブリッシングおよびディストリビューションの構成
このトピックでは、SQL Server Management Studio、Transact-SQL、またはレプリケーション管理オブジェクト (RMO) を使用して、SQL Server 2014 で発行と配布を構成する方法について説明します。
はじめに
セキュリティ
詳細については、「 セキュリティで保護されたレプリケーションのデプロイ」を参照してください。
SQL Server Management Studio を使用する
パブリケーションの新規作成ウィザードまたはディストリビューションの構成ウィザードを使用して、ディストリビューションを構成します。 ディストリビューターを構成したら、[ディストリビューターのプロパティ - <ディストリビューター> ] ダイアログ ボックスでプロパティを表示および変更します。 db_owner 固定データベース ロールのメンバーがパブリケーションを作成できるようにディストリビューターを構成する場合、またはパブリッシャーではないリモート ディストリビューターを構成する必要がある場合は、ディストリビューションの構成ウィザードを使用します。
ディストリビューションを構成するには
Microsoft SQL Server Management Studio で、ディストリビューターとなるサーバーに接続し (多くの場合、パブリッシャーとディストリビューターは同じサーバーです)、サーバー ノードを展開します。
[レプリケーション] フォルダーを右クリックし、 [ディストリビューションの構成] をクリックします。
ディストリビューションの構成ウィザードに従って、次の操作を実行します。
ディストリビューターを選択します。 ローカル ディストリビューターを使用するには、[ServerName]> を選択<すると、独自のディストリビューターとして機能します。SQL Serverでは、ディストリビューション データベースとログが作成されます。 リモート ディストリビューターを使用するには、 [以下のサーバーをディストリビューターとして使用する] を選択し、サーバーを選択します。 このサーバーは既にディストリビューターとして構成されている必要があり、パブリッシャーではこのディストリビューターを使用できるようになっている必要があります。 詳細については、「ディストリビューターでリモート パブリッシャーを有効にする (SQL Server Management Studio)」を参照してください。
リモート ディストリビューターを選択した場合、パブリッシャーからディストリビューターへの接続に対して、 [管理パスワード] ページでパスワードを入力する必要があります。 このパスワードは、リモート ディストリビューターでパブリッシャーを有効にしたときに指定したパスワードと一致する必要があります。
ローカル ディストリビューターに対してルート スナップショット フォルダーを指定します。 スナップショット フォルダーは、共有として指定したディレクトリです。このフォルダーの読み取りと書き込みをするエージェントには、このフォルダーへのアクセスを可能にする十分な権限が必要です。 このディストリビューターを使用する各パブリッシャーによって、ルート フォルダーの下にフォルダーが作成され、各パブリケーションでは、パブリッシャー フォルダーの下にスナップショット ファイルを格納するフォルダーが作成されます。 フォルダーの適切なセキュリティ保護の詳細については、「スナップショット フォルダーのセキュリティ保護」を参照してください。
ローカル ディストリビューターに対してディストリビューション データベースを指定します。 ディストリビューション データベースには、すべての種類のレプリケーションのメタデータと履歴データ、およびトランザクション レプリケーションに対するトランザクションが格納されます。
必要に応じて、その他のパブリッシャーでディストリビューターを使用できるようにします。 その他のパブリッシャーがディストリビューターを使用できるようになっている場合は、これらのパブリッシャーからディストリビューターへの接続に対して、 [ディストリビューター パスワード] ページでパスワードを入力する必要があります。
必要に応じて、構成の設定のスクリプトを作成します。 詳細については、「レプリケーションのスクリプト作成」を参照してください。
Transact-SQL の使用
レプリケーションのパブリッシングおよびディストリビューションは、レプリケーションのストアド プロシージャを使用してプログラムから構成できます。
ローカル ディストリビューターを使用してパブリッシングを構成するには
sp_get_distributor (Transact-SQL) を実行して、サーバーがディストリビューターとして既に構成されているかどうかを確認します。
結果セットに インストールされている の値が 0 の場合は、マスター データベースのディストリビューターで sp_adddistributor (Transact-SQL) を実行します。
結果セットに インストールされているディストリビューション db の値が 0 の場合は、マスター データベースのディストリビューターで sp_adddistributiondb (Transact-SQL) を実行します。 このとき、 @databaseに、ディストリビューション データベースの名前を指定します。 必要に応じて、トランザクションの最大保有期間 ( @max_distretention ) および履歴保有期間 ( @history_retention) を指定することもできます。 新しいデータベースを作成する場合は、必要なデータベース プロパティのパラメーターを指定します。
パブリッシャーでもあるディストリビューターで、sp_adddistpublisher (Transact-SQL) を実行し、@working_directoryの既定のスナップショット フォルダーとして使用される UNC 共有を指定します。
パブリッシャーで、 sp_replicationdboption (Transact-SQL) を実行します。 @dbnameにパブリッシュするデータベース、@optnameのレプリケーションの種類、および @value の
true値を指定します。
リモート ディストリビューターを使用してパブリッシングを構成するには
sp_get_distributor (Transact-SQL) を実行して、サーバーがディストリビューターとして既に構成されているかどうかを確認します。
結果セットに インストールされている の値が 0 の場合は、マスター データベースのディストリビューターで sp_adddistributor (Transact-SQL) を実行します。 @passwordには強力なパスワードを指定してください。 この distributor_admin アカウントのパスワードは、パブリッシャーがディストリビューターに接続する際に使用されます。
結果セットに インストールされているディストリビューション db の値が 0 の場合は、マスター データベースのディストリビューターで sp_adddistributiondb (Transact-SQL) を実行します。 このとき、 @databaseに、ディストリビューション データベースの名前を指定します。 必要に応じて、トランザクションの最大保有期間 ( @max_distretention ) および履歴保有期間 ( @history_retention) を指定することもできます。 新しいデータベースを作成する場合は、必要なデータベース プロパティのパラメーターを指定します。
ディストリビューターで、sp_adddistpublisher (Transact-SQL) を実行し、@working_directoryの既定のスナップショット フォルダーとして使用される UNC 共有を指定します。 パブリッシャーへの接続時にディストリビューターがSQL Server認証を使用する場合は、@security_modeに値 0 を指定し、@loginと@passwordの Microsoft SQL Server ログイン情報も指定する必要があります。
マスター データベースのパブリッシャーで、 sp_adddistributor (Transact-SQL) を実行します。 @passwordには、手順 1. で使用した強力なパスワードを指定してください。 このパスワードは、パブリッシャーがディストリビューターに接続する際に使用されます。
パブリッシャーで、 sp_replicationdboption (Transact-SQL) を実行します。 このとき、 @dbnameにはパブリッシュするデータベースを、 @optnameにはレプリケーションの種類を、 @valueの値には true を指定します。
例 (Transact-SQL)
次の例に、パブリッシングおよびディストリビューションをプログラムから構成する方法を示します。 この例では、パブリッシャーおよびローカル ディストリビューターとして構成するサーバーの名前をスクリプト変数を使って指定しています。 レプリケーションのパブリッシングおよびディストリビューションは、レプリケーションのストアド プロシージャを使用してプログラムから構成できます。
-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables
-- on the command line and in SQL Server Management Studio, see the
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".
-- Install the Distributor and the distribution database.
DECLARE @distributor AS sysname;
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @directory AS nvarchar(500);
DECLARE @publicationDB AS sysname;
-- Specify the Distributor name.
SET @distributor = $(DistPubServer);
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
-- Specify the replication working directory.
SET @directory = N'\\' + $(DistPubServer) + '\repldata';
-- Specify the publication database.
SET @publicationDB = N'AdventureWorks2012';
-- Install the server MYDISTPUB as a Distributor using the defaults,
-- including autogenerating the distributor password.
USE master
EXEC sp_adddistributor @distributor = @distributor;
-- Create a new distribution database using the defaults, including
-- using Windows Authentication.
USE master
EXEC sp_adddistributiondb @database = @distributionDB,
@security_mode = 1;
GO
-- Create a Publisher and enable AdventureWorks2012 for replication.
-- Add MYDISTPUB as a publisher with MYDISTPUB as a local distributor
-- and use Windows Authentication.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
USE [distribution]
EXEC sp_adddistpublisher @publisher=@publisher,
@distribution_db=@distributionDB,
@security_mode = 1;
GO
レプリケーション管理オブジェクト (RMO) の使用
パブリッシングおよびディストリビューションを単一サーバーで構成するには
ServerConnection クラスを使用して、サーバーへの接続を作成します。
ReplicationServer クラスのインスタンスを作成します。 手順 1. の ServerConnection を渡します。
DistributionDatabase クラスのインスタンスを作成します。
Name プロパティにデータベース名を設定し、 ConnectionContext プロパティに手順 1. の ServerConnection を設定します。
InstallDistributor メソッドを呼び出してディストリビューターをインストールします。 手順 3 の DistributionDatabase オブジェクトを渡します。
DistributionPublisher クラスのインスタンスを作成します。
次の DistributionPublisherのプロパティを設定します。
Name - パブリッシャーの名前。
ConnectionContext - 手順 1. の ServerConnection 。
DistributionDatabase - 手順 5. で作成したデータベースの名前。
WorkingDirectory - スナップショット ファイルのアクセスに使用する共有。
PublisherSecurity - パブリッシャーに接続するときに使用されるセキュリティ モード。 WindowsAuthentication が推奨されます。
Create メソッドを呼び出します。
リモート ディストリビューターを使用してパブリッシングおよびディストリビューションを構成するには
ServerConnection クラスを使用して、リモート ディストリビューター サーバーへの接続を作成します。
ReplicationServer クラスのインスタンスを作成します。 手順 1. の ServerConnection を渡します。
DistributionDatabase クラスのインスタンスを作成します。
Name プロパティにデータベース名を設定し、 ConnectionContext プロパティに手順 1. の ServerConnection を設定します。
InstallDistributor メソッドを呼び出してディストリビューターをインストールします。 安全なパスワード (パブリッシャーがリモート ディストリビューターへの接続時に使用) および手順 3. の DistributionDatabase オブジェクトを指定します。 詳細については、「ディストリビューターのセキュリティ保護」を参照してください。
重要
可能であれば、実行時、ユーザーに対してセキュリティ資格情報の入力を要求します。 資格情報を保存する必要がある場合は、 Windows .NET Framework に用意されている 暗号化サービス Microsoft を使用します。
DistributionPublisher クラスのインスタンスを作成します。
次の DistributionPublisherのプロパティを設定します。
Name - ローカル パブリッシャー サーバーの名前。
ConnectionContext - 手順 1. の ServerConnection 。
DistributionDatabase - 手順 5. で作成したデータベースの名前。
WorkingDirectory - スナップショット ファイルのアクセスに使用する共有。
PublisherSecurity - パブリッシャーに接続するときに使用されるセキュリティ モード。 WindowsAuthentication が推奨されます。
Create メソッドを呼び出します。
ServerConnection クラスを使用して、ローカル パブリッシャー サーバーへの接続を作成します。
ReplicationServer クラスのインスタンスを作成します。 手順 9. の ServerConnection を渡します。
InstallDistributor メソッドを呼び出します。 リモート ディストリビューターの名前、および手順 5. で指定したリモート ディストリビューターのパスワードを渡します。
重要
可能であれば、実行時、ユーザーに対してセキュリティ資格情報の入力を要求します。 資格情報を保存する必要がある場合は、Windows .NET Framework に用意されている 暗号化サービス を使用します。
例 (RMO)
レプリケーション管理オブジェクト (RMO) を使用することで、プログラムによってレプリケーション パブリッシングおよびディストリビューションを構成できます。
// 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
参照
ディストリビューターとパブリッシャーのプロパティの表示および変更
Replication System Stored Procedures Concepts
[ディストリビューションの構成]
レプリケーション管理オブジェクトの概念
AlwaysOn 可用性グループ用のレプリケーションの構成 (SQL Server)