初期スナップショットを作成して適用する

2017-06-13

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

このトピックについて

初期スナップショットを作成して適用するには、次を使用します。

SQL Server Management Studio

Transact-SQL

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

SQL Server Management Studio の使用

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

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

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

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

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

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

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

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

Transact-SQL の使用

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

重要

可能な場合は、実行時にセキュリティ資格情報の入力をユーザーに求めます。スクリプトファイルに資格情報を格納する必要がある場合は、未承認のアクセスを防ぐためにファイルをセキュリティで保護する必要があります。

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

スナップショットパブリケーション、トランザクションパブリケーション、またはマージパブリケーションを作成します。詳細については、「パブリケーションの作成」を参照してください。
sp_addpublication_snapshot (Transact-SQL) を実行します。 @publicationと次のパラメーターを指定します。
- @job_login。スナップショットエージェントがディストリビューターで実行される Windows 認証資格情報を指定します。
- ** @job_password**。指定された Windows 資格情報のパスワードです。
- (省略可能)パブリッシャーに接続するときにエージェントが SQL Server 認証を使用する場合、@publisher_security_modeの値は 0 です。この場合は、 @publisher_login と @publisher_passwordの SQL Server 認証ログイン情報も指定する必要があります。
- (省略可能)スナップショットエージェントジョブの同期スケジュール。詳細については、「同期スケジュールの指定」を参照してください。
重要

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

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

スナップショットパブリケーション、トランザクションパブリケーション、またはマージパブリケーションを作成します。詳細については、「パブリケーションの作成」を参照してください。
パブリケーションにアーティクルを追加します。詳細については、アーティクルの定義を参照してください。
コマンドプロンプトまたはバッチファイルで、次のコマンドライン引数を指定して、snapshot.exeを実行してレプリケーションスナップショットエージェントを起動します。
- -出版
- -発行者
- -ディストリビューター
- -PublisherDB
- -レプリケーションの種類
SQL Server 認証を使用している場合は、次の引数も指定する必要があります。
- -DistributorLogin
- -ディストリビューターパスワード
- -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 行で行う必要があります。

@ECHO OFF
SET InstanceName=%computername%
REM<snippetstartmergesnapshot_10>
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\120\COM\SNAPSHOT.EXE" -Publication %Publication% 
-Publisher %Publisher% -Distributor %Publisher% -PublisherDB %PublicationDB% 
-ReplicationType 2 -OutputVerboseLevel 1 -DistributorSecurityMode 1 
REM</snippetstartmergesnapshot_10>

PAUSE

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

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

重要

可能な場合は、実行時にセキュリティ資格情報の入力をユーザーに求めます。資格情報を格納する必要がある場合は、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 認証を使用するDistributorLoginとDistributorPasswordの値Standardと値。 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

こちらもご覧ください

パブリケーションを作成する
 プルサブスクリプションを作成する
 プッシュサブスクリプションを作成する
 同期スケジュールの指定
 スナップショットの作成と適用
 スナップショットを使用してサブスクリプションを初期化する
 レプリケーション管理オブジェクトの概念
 レプリケーションのセキュリティに関するベストプラクティス
 レプリケーションシステムストアドプロシージャの概念
 sqlcmd でのスクリプト変数の使用

次の方法で共有

初期スナップショットを作成して適用する

SQL Server Management Studio の使用

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

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

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

Transact-SQL の使用

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

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

例 (Transact-SQL)

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

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

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

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

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