初期スナップショットの作成および適用

[アーティクル]
06/18/2013

このトピックでは、SQL Server 2012 で SQL Server Management Studio、Transact-SQL、またはレプリケーション管理オブジェクト (RMO) を使用して、初期スナップショットを作成および適用する方法について説明します。パラメーター化されたフィルターを使用するマージパブリケーションでは、2 つの部分から成るスナップショットが必要です。詳細については、「パラメーター化されたフィルターを使用したパブリケーションのスナップショットの作成」を参照してください。

このトピックの内容

初期スナップショットを作成および適用するために使用するもの:

SQL Server Management Studio

Transact-SQL

レプリケーション管理オブジェクト (RMO)

SQL Server Management Studio の使用

既定では、SQL Server エージェントが実行されている場合、パブリケーションの新規作成ウィザードでパブリケーションが作成された直後に、スナップショットエージェントによってスナップショットが生成されます。既定では、スナップショットはディストリビューションエージェント (スナップショットレプリケーションおよびトランザクションレプリケーションの場合) またはマージエージェント (マージサブスクリプションの場合) によって、すべてのサブスクリプションに対して適用されます。スナップショットは、SQL Server Management Studio およびレプリケーションモニターを使用して生成することもできます。レプリケーションモニターの起動の詳細については、「レプリケーションモニターの開始」を参照してください。

Management Studio でスナップショットを作成するには

Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、[ローカルパブリケーション] フォルダーを展開します。
スナップショットを作成するパブリケーションを右クリックして、[スナップショットエージェントの状態の表示] をクリックします。
[スナップショットエージェントの状態の表示 - <Publication>] ダイアログボックスで [開始] をクリックします。

スナップショットエージェントによるスナップショットの生成が完了すると、"[100%] 17 個のアーティクルのスナップショットが生成されました。" などのメッセージが表示されます。

レプリケーションモニターでスナップショットを作成するには

レプリケーションモニターの左ペインでパブリッシャーグループを展開し、パブリッシャーを展開します。
スナップショットを生成するパブリケーションを右クリックして、[スナップショットの生成] をクリックします。
スナップショットエージェントの状態を表示するには、[エージェント] タブをクリックします。詳細情報については、グリッドでスナップショットエージェントを右クリックし、[詳細表示] をクリックしてください。

スナップショットを適用するには

生成したスナップショットは、ディストリビューションエージェントまたはマージエージェントによるサブスクリプションの同期によって適用されます。
- エージェントを連続して実行するように設定している場合 (トランザクションレプリケーションの既定の動作)、スナップショットは生成後に自動的に適用されます。
- スケジュールに基づいてエージェントを実行するように設定している場合、スナップショットは、スケジュールによる次回のエージェント実行時に適用されます。
- 要求時にエージェントを実行するように設定している場合、スナップショットは、次回のエージェント実行時に適用されます。
サブスクリプションの同期の詳細については、「プッシュサブスクリプションの同期」および「プルサブスクリプションの同期」を参照してください。

[トップに戻る] リンクで使用される矢印アイコン [Top]

Transact-SQL の使用

初期スナップショットは、スナップショットエージェントジョブを作成、実行するか、スナップショットエージェントの実行可能ファイルをバッチファイルから実行することによってプログラムから作成できます。生成された初期スナップショットは、サブスクリプションの初回同期時にサブスクライバーに転送されて適用されます。スナップショットエージェントをコマンドプロンプトまたはバッチファイルから実行する場合、既存のスナップショットが無効になるたびにエージェントを再実行する必要があります。

セキュリティに関する注意
可能ならば、実行時にセキュリティ資格情報の入力を求めるメッセージをユーザーに対して表示します。スクリプトファイルに資格情報を格納する必要がある場合、不正なアクセスを防ぐために、ファイルをセキュリティ保護する必要があります。

スナップショットエージェントジョブを作成、実行して初期スナップショットを生成するには

スナップショットパブリケーション、トランザクションパブリケーション、またはマージパブリケーションを作成します。詳細については、「パブリケーションの作成」を参照してください。

sp_addpublication_snapshot (Transact-SQL) を実行します。このとき、@publication パラメーターを指定したうえで、次のパラメーターを指定します。

ディストリビューターで実行するスナップショットエージェントが使用するための Windows 認証の資格情報を @job_login に指定します。
Windows 資格情報に対応するパスワードを @job_password に指定します。
(省略可) エージェントからパブリッシャーへの接続に SQL Server 認証を使用する場合は、@publisher_security_mode の値に 0 を指定します。この場合は、さらに、@publisher_login および @publisher_password に対して、SQL Server 認証のログイン情報を指定する必要があります。
(省略可) スナップショットエージェントジョブの同期スケジュールを指定します。詳細については、「同期スケジュールの指定」を参照してください。

セキュリティに関する注意
リモートディストリビューターを使用するパブリッシャーを構成する場合は、job_login および job_password を含むすべてのパラメーターに指定された値がディストリビューターにプレーンテキストとして送信されます。このストアドプロシージャを実行する前に、パブリッシャーとそのリモートディストリビューター間の接続を暗号化する必要があります。詳細については、「データベースエンジンへの暗号化接続の有効化 (SQL Server 構成マネージャー)」を参照してください。

リモートディストリビューターを使用するパブリッシャーを構成する場合は、job_login および job_password を含むすべてのパラメーターに指定された値がディストリビューターにプレーンテキストとして送信されます。このストアドプロシージャを実行する前に、パブリッシャーとそのリモートディストリビューター間の接続を暗号化する必要があります。詳細については、「データベースエンジンへの暗号化接続の有効化 (SQL Server 構成マネージャー)」を参照してください。

パブリケーションにアーティクルを追加します。詳細については、「アーティクルの定義」を参照してください。
パブリッシャーのパブリケーションデータベースで sp_startpublication_snapshot (Transact-SQL) を実行します。このとき、手順 1. の @publication を指定します。

スナップショットエージェントを実行して初期スナップショットを生成するには

スナップショットパブリケーション、トランザクションパブリケーション、またはマージパブリケーションを作成します。詳細については、「パブリケーションの作成」を参照してください。
パブリケーションにアーティクルを追加します。詳細については、「アーティクルの定義」を参照してください。
コマンドプロンプトまたはバッチファイルから、次のコマンドライン引数を指定して snapshot.exe を実行し、レプリケーションスナップショットエージェントを起動します。
- -Publication
- -Publisher
- -Distributor
- -PublisherDB
- -ReplicationType
SQL Server 認証を使用する場合は、次の引数も指定する必要があります。
- -DistributorLogin
- -DistributorPassword
- -DistributorSecurityMode = 0
- -PublisherLogin
- -PublisherPassword
- -PublisherSecurityMode = 0

例 (Transact-SQL)

次の例では、トランザクションパブリケーションを作成し、sqlcmd スクリプト変数を使用して、新しいパブリケーション用にスナップショットエージェントジョブを追加します。ジョブを開始するコードも含まれています。

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. 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".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2012'; --publication database
SET @publication = N'AdvWorksCustomerTran'; -- transactional publication name
SET @login = $(Login);
SET @password = $(Password);

USE [AdventureWorks]

-- Enable transactional and snapshot replication on the publication database.
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'publish',
  @value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
  @job_login = @login, 
  @job_password = @password,
  -- Explicitly specify the security mode used when connecting to the Publisher.
  @publisher_security_mode = 1;

-- Create new transactional publication, using the defaults. 
USE [AdventureWorks2012]
EXEC sp_addpublication 
  @publication = @publication, 
  @description = N'transactional publication';

-- Create a new snapshot job for the publication, using the defaults.
EXEC sp_addpublication_snapshot 
  @publication = @publication,
  @job_login = @login,
  @job_password = @password;

-- Start the Snapshot Agent job.
EXEC sp_startpublication_snapshot @publication = @publication;
GO

次の例では、マージパブリケーションを作成し、sqlcmd 変数を使用して、そのパブリケーション用のスナップショットエージェントジョブを追加します。ジョブを開始するコードも含まれています。

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. 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".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2012'; 
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @login = $(Login);
SET @password = $(Password);

-- Enable merge replication on the publication database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname=N'merge publish',
  @value = N'true';

-- Create new merge publication, using the defaults. 
USE [AdventureWorks]
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication.';

-- Create a new snapshot job for the publication, using the defaults.
EXEC sp_addpublication_snapshot 
  @publication = @publication,
  @job_login = @login,
  @job_password = @password;

-- Start the Snapshot Agent job.
EXEC sp_startpublication_snapshot @publication = @publication;
GO

次のコマンドライン引数は、スナップショットエージェントを起動して、マージパブリケーション用のスナップショットを生成します。

注
読みやすくするために、改行が追加されています。バッチファイルの場合、コマンドは 1 行で入力する必要があります。

REM -- Declare variables
SET Publisher=%InstanceName%
SET PublicationDB=AdventureWorks2012 
SET Publication=AdvWorksSalesOrdersMerge 

REM --Start the Snapshot Agent to generate the snapshot for AdvWorksSalesOrdersMerge.
"C:\Program Files\Microsoft SQL Server\110\COM\SNAPSHOT.EXE" -Publication %Publication% 
-Publisher %Publisher% -Distributor %Publisher% -PublisherDB %PublicationDB% 
-ReplicationType 2 -OutputVerboseLevel 1 -DistributorSecurityMode 1

[トップに戻る] リンクで使用される矢印アイコン [Top]

レプリケーション管理オブジェクト (RMO) の使用

スナップショットエージェントは、パブリッシャーが作成された後でスナップショットを生成します。レプリケーション管理オブジェクト (RMO) およびレプリケーションエージェント機能への直接的なマネージコードアクセスを使用して、これらのスナップショットをプログラムで生成できます。使用するオブジェクトは、レプリケーションの種類によって異なります。スナップショットエージェントを同期的に開始する場合は SnapshotGenerationAgent オブジェクトを使用し、非同期的に開始する場合はエージェントジョブを使用します。初期スナップショットの生成後、サブスクリプションを最初に同期するときに、初期スナップショットをサブスクライバーに転送して適用することができます。既存のスナップショットに最新の有効なデータが含まれていない場合は、エージェントを再実行する必要があります。詳細については、「パブリケーションの管理」を参照してください。

セキュリティに関する注意
可能ならば、実行時にセキュリティ資格情報の入力を求めるメッセージをユーザーに対して表示します。資格情報を保存する必要がある場合は、Microsoft Windows .NET Framework に用意されている暗号化サービスを使用します。

スナップショットエージェントジョブを非同期的に開始して、スナップショットパブリケーションまたはトランザクションパブリケーションの初期スナップショットを生成するには

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
TransPublication クラスのインスタンスを作成します。パブリケーションの Name プロパティおよび DatabaseName プロパティを設定し、ConnectionContext プロパティに手順 1. で作成した接続を設定します。
LoadProperties メソッドを呼び出して、オブジェクトの残りのプロパティを読み込みます。このメソッドが false を返す場合、手順 2. でパブリケーションプロパティを不適切に設定したか、パブリケーションが存在していません。
SnapshotAgentExists の値が false の場合は、CreateSnapshotAgent を呼び出して、このパブリケーション用のスナップショットエージェントジョブを作成します。
StartSnapshotGenerationAgentJob メソッドを呼び出して、このパブリケーションのスナップショットを生成するエージェントジョブを開始します。
(省略可) SnapshotAvailable の値が true である場合は、スナップショットをサブスクライバーに使用できます。

スナップショットエージェントジョブを同期的に実行して、スナップショットパブリケーションまたはトランザクションパブリケーションの初期スナップショットを生成するには

SnapshotGenerationAgent クラスのインスタンスを作成し、次の必須プロパティを設定します。
- Publisher - パブリッシャーの名前
- PublisherDatabase - パブリケーションデータベースの名前
- Publication - パブリケーションの名前
- Distributor - ディストリビューターの名前
- PublisherSecurityMode - パブリッシャーへの接続時に Windows 認証を使用する場合は Integrated を指定します。パブリッシャーへの接続時に SQL Server 認証を使用する場合は Standard を指定し、PublisherLogin および PublisherPassword に値を指定します。推奨されるのは、Windows 認証です。
- DistributorSecurityMode - ディストリビューターへの接続時に Windows 認証を使用する場合は Integrated を指定します。ディストリビューターへの接続時に SQL Server 認証を使用する場合は Standard を指定し、DistributorLogin および DistributorPassword に値を指定します。推奨されるのは、Windows 認証です。
ReplicationType に Transactional または Snapshot を設定します。
GenerateSnapshot メソッドを呼び出します。

スナップショットエージェントジョブを非同期的に開始して、マージパブリケーションの初期スナップショットを生成するには

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
MergePublication クラスのインスタンスを作成します。パブリケーションの Name プロパティおよび DatabaseName プロパティを設定し、ConnectionContext プロパティに手順 1. で作成した接続を設定します。
LoadProperties メソッドを呼び出して、オブジェクトの残りのプロパティを読み込みます。このメソッドが false を返す場合、手順 2. でパブリケーションプロパティを不適切に設定したか、パブリケーションが存在していません。
SnapshotAgentExists の値が false の場合は、CreateSnapshotAgent を呼び出して、このパブリケーション用のスナップショットエージェントジョブを作成します。
StartSnapshotGenerationAgentJob メソッドを呼び出して、このパブリケーションのスナップショットを生成するエージェントジョブを開始します。
(省略可) SnapshotAvailable の値が true である場合は、スナップショットをサブスクライバーに使用できます。

スナップショットエージェントを同期的に実行して、マージパブリケーションの初期スナップショットを生成するには

SnapshotGenerationAgent クラスのインスタンスを作成し、次の必須プロパティを設定します。
- Publisher - パブリッシャーの名前
- PublisherDatabase - パブリケーションデータベースの名前
- Publication - パブリケーションの名前
- Distributor - ディストリビューターの名前
- PublisherSecurityMode - パブリッシャーへの接続時に Windows 認証を使用する場合は Integrated を指定します。パブリッシャーへの接続時に SQL Server 認証を使用する場合は Standard を指定し、PublisherLogin および PublisherPassword に値を指定します。推奨されるのは、Windows 認証です。
- DistributorSecurityMode - ディストリビューターへの接続時に Windows 認証を使用する場合は Integrated を指定します。ディストリビューターへの接続時に SQL Server 認証を使用する場合は Standard を指定し、DistributorLogin および DistributorPassword に値を指定します。推奨されるのは、Windows 認証です。
ReplicationType に Merge を設定します。
GenerateSnapshot メソッドを呼び出します。

例 (RMO)

次の例では、スナップショットエージェントを同期的に実行して、トランザクションパブリケーションの初期スナップショットを生成します。

          // Set the Publisher, publication database, and publication names.
            string publicationName = "AdvWorksProductTran";
            string publicationDbName = "AdventureWorks2012";
            string publisherName = publisherInstance;
            string distributorName = publisherInstance;

            SnapshotGenerationAgent agent;

            try
            {
                // Set the required properties for Snapshot Agent.
                agent = new SnapshotGenerationAgent();
                agent.Distributor = distributorName;
                agent.DistributorSecurityMode = SecurityMode.Integrated;
                agent.Publisher = publisherName;
                agent.PublisherSecurityMode = SecurityMode.Integrated;
                agent.Publication = publicationName;
                agent.PublisherDatabase = publicationDbName;
                agent.ReplicationType = ReplicationType.Transactional;

                // Start the agent synchronously.
                agent.GenerateSnapshot();

            }
            catch (Exception ex)
            {
                // Implement custom application error handling here.
                throw new ApplicationException(String.Format(
                    "A snapshot could not be generated for the {0} publication."
                    , publicationName), ex);
            }

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance
Dim distributorName As String = publisherInstance

Dim agent As SnapshotGenerationAgent

Try
    ' Set the required properties for Snapshot Agent.
    agent = New SnapshotGenerationAgent()
    agent.Distributor = distributorName
    agent.DistributorSecurityMode = SecurityMode.Integrated
    agent.Publisher = publisherName
    agent.PublisherSecurityMode = SecurityMode.Integrated
    agent.Publication = publicationName
    agent.PublisherDatabase = publicationDbName
    agent.ReplicationType = ReplicationType.Transactional

    ' Start the agent synchronously.
    agent.GenerateSnapshot()

Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
End Try

次の例では、エージェントジョブを非同期的に開始して、トランザクションパブリケーションの初期スナップショットを生成します。

          // Set the Publisher, publication database, and publication names.
            string publicationName = "AdvWorksProductTran";
            string publicationDbName = "AdventureWorks2012";
            string publisherName = publisherInstance;

            TransPublication publication;

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

            try
            {
                // Connect to the Publisher.
                conn.Connect();

                // Set the required properties for an existing publication.
                publication = new TransPublication();
                publication.ConnectionContext = conn;
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;

                if (publication.LoadProperties())
                {
                    // Start the Snapshot Agent job for the publication.
                    publication.StartSnapshotGenerationAgentJob();
                }
                else
                {
                    throw new ApplicationException(String.Format(
                        "The {0} publication does not exist.", publicationName));
                }
            }
            catch (Exception ex)
            {
                // Implement custom application error handling here.
                throw new ApplicationException(String.Format(
                    "A snapshot could not be generated for the {0} publication."
                    , publicationName), ex);
            }
            finally
            {
                conn.Disconnect();
            }

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance

Dim publication As TransPublication

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

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Set the required properties for an existing publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    If publication.LoadProperties() Then
        ' Start the Snapshot Agent job for the publication.
        publication.StartSnapshotGenerationAgentJob()
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} publication does not exist.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
Finally
    conn.Disconnect()
End Try

[トップに戻る] リンクで使用される矢印アイコン [Top]

次の方法で共有

初期スナップショットの作成および適用

SQL Server Management Studio の使用

Management Studio でスナップショットを作成するには

レプリケーションモニターでスナップショットを作成するには

スナップショットを適用するには

Transact-SQL の使用

スナップショットエージェントジョブを作成、実行して初期スナップショットを生成するには

スナップショットエージェントを実行して初期スナップショットを生成するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショットエージェントジョブを非同期的に開始して、スナップショットパブリケーションまたはトランザクションパブリケーションの初期スナップショットを生成するには

スナップショットエージェントジョブを同期的に実行して、スナップショットパブリケーションまたはトランザクションパブリケーションの初期スナップショットを生成するには

スナップショットエージェントジョブを非同期的に開始して、マージパブリケーションの初期スナップショットを生成するには

スナップショットエージェントを同期的に実行して、マージパブリケーションの初期スナップショットを生成するには

例 (RMO)

関連項目

概念

その他のリソース

次の方法で共有

初期スナップショットの作成および適用

SQL Server Management Studio の使用

Management Studio でスナップショットを作成するには

レプリケーション モニターでスナップショットを作成するには

スナップショットを適用するには

Transact-SQL の使用

スナップショット エージェント ジョブを作成、実行して初期スナップショットを生成するには

スナップショット エージェントを実行して初期スナップショットを生成するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショット エージェント ジョブを非同期的に開始して、スナップショット パブリケーションまたはトランザクション パブリケーションの初期スナップショットを生成するには

スナップショット エージェント ジョブを同期的に実行して、スナップショット パブリケーションまたはトランザクション パブリケーションの初期スナップショットを生成するには

スナップショット エージェント ジョブを非同期的に開始して、マージ パブリケーションの初期スナップショットを生成するには

スナップショット エージェントを同期的に実行して、マージ パブリケーションの初期スナップショットを生成するには

例 (RMO)

関連項目

概念

その他のリソース

レプリケーションモニターでスナップショットを作成するには

スナップショットエージェントジョブを作成、実行して初期スナップショットを生成するには

スナップショットエージェントを実行して初期スナップショットを生成するには

スナップショットエージェントジョブを非同期的に開始して、スナップショットパブリケーションまたはトランザクションパブリケーションの初期スナップショットを生成するには

スナップショットエージェントジョブを同期的に実行して、スナップショットパブリケーションまたはトランザクションパブリケーションの初期スナップショットを生成するには

スナップショットエージェントジョブを非同期的に開始して、マージパブリケーションの初期スナップショットを生成するには

スナップショットエージェントを同期的に実行して、マージパブリケーションの初期スナップショットを生成するには