レプリケーションスクリプトのアップグレード (レプリケーション Transact-SQL プログラミング)

[アーティクル]
06/13/2017

Transact-SQL スクリプトファイルを使用して、レプリケーショントポロジをプログラムで構成できます。詳細については、「Replication System Stored Procedures Concepts」 (レプリケーションシステムストアドプロシージャの概念) を参照してください。

重要

sysadmin ロールのメンバーが実行するスクリプトについては、アップグレードは必須ではありませんが、このトピックの説明に従って既存のスクリプトを変更することをお勧めします。「 Replication Agent Security Model」の「エージェントに必要な権限」に記載されている各レプリケーションエージェントの最小権限を持つアカウントを指定します。

このようにセキュリティが強化されたことで、レプリケーションエージェントジョブの実行に使用される Microsoft Windows アカウントを明示的に指定できるため、権限をより詳細に設定できます。既存のスクリプトに含まれる次のストアドプロシージャは、このセキュリティ強化の影響を受けます。

sp_addpublication_snapshot

sp_addpublication_snapshot (Transact-SQL) を実行するときに、@job_loginとして Windows 資格情報を指定し、@job_passwordして、ディストリビューターでスナップショットエージェントが実行されるジョブを作成する必要があります。
sp_addpushsubscription_agent

ここで、sp_addpushsubscription_agent (Transact-SQL) を実行してジョブを明示的に追加し、ディストリビューションエージェントジョブがディストリビューターで実行される Windows 資格情報 (@job_loginと@job_password) を指定する必要があります。 2005 年SQL Serverより前のバージョンのSQL Serverでは、これはプッシュサブスクリプションが作成されたときに自動的に行われました。
sp_addmergepushsubscription_agent

ここで、sp_addmergepushsubscription_agent (Transact-SQL) を実行してジョブを明示的に追加し、マージエージェントジョブがディストリビューターで実行される Windows 資格情報 (@job_loginと@job_password) を指定する必要があります。 2005 年SQL Serverより前のバージョンのSQL Serverでは、これはプッシュサブスクリプションが作成されたときに自動的に行われました。
sp_addpullsubscription_agent

sp_addpullsubscription_agent (Transact-SQL) を実行するときに、@job_loginとして Windows 資格情報を指定し、@job_passwordして、サブスクライバーでディストリビューションエージェントが実行されるジョブを作成する必要があります。
sp_addmergepullsubscription_agent

sp_addmergepullsubscription_agent (Transact-SQL) を実行するときに、@job_loginとして Windows 資格情報を指定し、@job_passwordして、サブスクライバーでマージエージェントが実行されるジョブを作成する必要があります。
sp_addlogreader_agent

ここで、sp_addlogreader_agent (Transact-SQL) を実行してジョブを手動で追加し、ディストリビューターでログリーダーエージェントが実行される Windows 資格情報を指定する必要があります。 2005 年SQL Serverより前のバージョンのSQL Serverでは、トランザクションパブリケーションが作成されたときに自動的に行われました。
sp_addqreader_agent

ここで、sp_addqreader_agent (Transact-SQL) を実行してジョブを手動で追加し、キューリーダーエージェントがディストリビューターで実行される Windows 資格情報を指定する必要があります。 SQL Server 2005 より前のバージョンのSQL Serverでは、これは、キュー更新をサポートするトランザクションパブリケーションが作成されたときに自動的に行われました。

SQL Server 2005 で導入されたセキュリティモデルでは、レプリケーションエージェントは常に、@job_nameと@job_passwordで指定された資格情報を使用して、Windows 認証を使用して SQL Server のローカルインスタンスに接続します。レプリケーションエージェントジョブを実行する際に使用する Windows アカウントの要件の詳細については、「 Replication Agent Security Model」を参照してください。

重要

可能であれば、実行時、ユーザーに対してセキュリティ資格情報の入力を要求します。スクリプトファイルに資格情報を格納した場合は、ファイル自体が暗号化されていることを確認してください。

スナップショットパブリケーションまたはトランザクションパブリケーションを構成するスクリプトをアップグレードするには

既存のスクリプトで、 sp_addpublication (Transact-SQL) の前に、パブリケーションデータベースのパブリッシャーで sp_addlogreader_agent (Transact-SQL) を実行します。ログリーダーエージェントの実行に使用される Windows 資格情報を @job_name と @job_passwordに指定します。エージェントがパブリッシャーに接続するときにSQL Server認証を使用する場合は、@publisher_security_modeに値 0 を指定し、@publisher_loginと@publisher_passwordのSQL Serverログイン情報も指定する必要があります。 これにより、パブリケーションデータベース用のログリーダーエージェントジョブが作成されます。

注意

この手順はトランザクションパブリケーションにのみ適用されます。スナップショットパブリケーションの場合は不要です。
(省略可能) sp_addpublication (Transact-SQL) の前に、ディストリビューションデータベースのディストリビューターで sp_addqreader_agent (Transact-SQL) を実行します。キューリーダーエージェントの実行に使用される Windows 資格情報を @job_name と @job_passwordに指定します。これにより、ディストリビューター用のキューリーダーエージェントジョブが作成されます。

注意

この手順は、キュー更新サブスクライバーをサポートするトランザクションパブリケーションでのみ必要です。
(省略可能) sp_addpublication (Transact-SQL) の実行を更新して、新しいレプリケーション機能を実装するパラメーターの既定値以外の値を設定します。
sp_addpublication (Transact-SQL) の後、パブリケーションデータベースのパブリッシャーでsp_addpublication_snapshot (Transact-SQL) を実行します。 @publication を指定し、スナップショットエージェントを実行する際に使用される Windows 資格情報を @job_name および @job_passwordに指定します。エージェントがパブリッシャーに接続するときにSQL Server認証を使用する場合は、@publisher_security_modeに値 0 を指定し、@publisher_loginと@publisher_passwordのSQL Serverログイン情報も指定する必要があります。 これにより、パブリケーション用のスナップショットエージェントジョブが作成されます。
(省略可能) sp_addarticle (Transact-SQL) の実行を更新して、新しいレプリケーション機能を実装するパラメーターの既定値以外の値を設定します。

スナップショットパブリケーションまたはトランザクションパブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには

サブスクリプションを作成するストアドプロシージャを実行した後、ディストリビューションエージェントジョブを作成するストアドプロシージャを実行して、サブスクリプションを同期するようにしてください。使用するストアドプロシージャは、サブスクリプションの種類に応じて変わります。
- プルサブスクリプションの場合は、sp_addpullsubscription_agent (Transact-SQL) の実行を更新して、@job_nameと@job_passwordのサブスクライバーでディストリビューションエージェントが実行される Windows 資格情報を指定します。この操作は、 sp_addpullsubscriptionの実行後に行われます。詳細については、「プルサブスクリプションの作成」をご覧ください。
- プッシュサブスクリプションの場合は、パブリッシャーで sp_addpushsubscription_agent (Transact-SQL) を実行します。 @subscriber、 @subscriber_db、 @publicationを指定し、ディストリビューションエージェントをディストリビューターで実行するときに使用される Windows 資格情報を @job_name および @job_passwordに指定します。さらに、このエージェントジョブのスケジュールを指定します。詳細については、「 Specify Synchronization Schedules」を参照してください。この操作は、 sp_addsubscriptionの実行後に行われます。詳細については、「プッシュサブスクリプションの作成」をご覧ください。

マージパブリケーションを構成するスクリプトをアップグレードするには

(省略可能)既存のスクリプトで、 sp_addmergepublication (Transact-SQL) の実行を更新して、新しいレプリケーション機能を実装するパラメーターの既定値以外の値を設定します。
sp_addmergepublication (Transact-SQL) の後、パブリッシャーでパブリケーションデータベースでsp_addpublication_snapshot (Transact-SQL) を実行します。 @publication を指定し、スナップショットエージェントを実行する際に使用される Windows 資格情報を @job_name および @job_passwordに指定します。エージェントがパブリッシャーに接続するときにSQL Server認証を使用する場合は、@publisher_security_modeに値 0 を指定し、@publisher_loginと@publisher_passwordのSQL Serverログイン情報も指定する必要があります。 これにより、パブリケーション用のスナップショットエージェントジョブが作成されます。
(省略可能) sp_addmergearticle (Transact-SQL) の実行を更新して、新しいレプリケーション機能を実装するパラメーターの既定値以外の値を設定します。

マージパブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには

サブスクリプションを作成するストアドプロシージャを実行した後、マージエージェントジョブを作成するストアドプロシージャを実行して、サブスクリプションを同期するようにしてください。使用するストアドプロシージャは、サブスクリプションの種類に応じて変わります。
- プルサブスクリプションの場合は、sp_addmergepullsubscription_agent (Transact-SQL) の実行を更新して、@job_nameと@job_passwordのためにサブスクライバーでマージエージェントが実行される Windows 資格情報を指定します。この操作は、 sp_addmergepullsubscriptionの実行後に行われます。詳細については、「プルサブスクリプションの作成」をご覧ください。
- プッシュサブスクリプションの場合は、パブリッシャーで sp_addmergepushsubscription_agent (Transact-SQL) を実行します。 @subscriber、 @subscriber_db、 @publicationを指定し、マージエージェントをディストリビューターで実行するときに使用される Windows 資格情報を @job_name および @job_passwordに指定します。さらに、このエージェントジョブのスケジュールを指定します。詳細については、「 Specify Synchronization Schedules」を参照してください。この操作は、 sp_addmergesubscriptionの実行後に行われます。詳細については、「プッシュサブスクリプションの作成」をご覧ください。

例

Product テーブルのトランザクションパブリケーションを作成するSQL Server 2000 スクリプトの例を次に示します。このパブリケーションでは、フェールオーバーとしてキュー更新を使用する即時更新がサポートされます。読みやすくするために、既定のパラメーターは削除されています。

USE [Northwind]
GO

DECLARE @publication AS sysname
DECLARE @publicationDB AS sysname
DECLARE @article AS sysname
SET @publication = N'NwdProductTran'
SET @publicationDB = N'Northwind'
SET @article = N'Products'

-- Enable the replication database.
EXEC sp_replicationdboption 
    @dbname = @publicationDB, 
    @optname = N'publish', 
    @value = N'true'

-- Add the transactional publication.
EXEC sp_addpublication 
    @publication = @publication, 
    @sync_method = N'native', 
    @status = N'active', 
    @repl_freq = N'continuous', 
    @description = N'Transactional publication of Northwind.', 
    @allow_push = N'true', 
    @allow_pull = N'true', 
    @allow_sync_tran = N'true', 
    @autogen_sync_procs = N'true', 
    @allow_queued_tran = N'true'

-- Add a snapshot job.
EXEC sp_addpublication_snapshot 
    @publication = @publication

-- Add the transactional articles.
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @article, 
    @source_owner = N'dbo', 
    @source_object = @article, 
    @destination_table = @article, 
    @type = N'logbased', 
    @schema_option = 0x00000000000080F3, 
    @ins_cmd = N'CALL sp_MSins_Products', 
    @del_cmd = N'XCALL sp_MSdel_Products', 
    @upd_cmd = N'XCALL sp_MSupd_Products', 
    @auto_identity_range = N'false'
GO

例

次に、トランザクションパブリケーションを作成する前のスクリプトをアップグレードして、SQL Server 2005 以降のバージョンで正常に実行する例を示します。このパブリケーションでは、フェールオーバーとしてキュー更新を使用する即時更新がサポートされます。新しいパラメーターの既定値は、明示的に宣言されています。

注意

Windows 資格情報は、 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".

-- Execute at the Distributor.
USE [distribution]

DECLARE @login AS sysname;
DECLARE @password AS sysname;
-- Specify the Windows account to run the Queue Reader Agent.
SET @login = $(Login); 
-- Pass the password at runtime.
SET @password = $(Password); 

-- Execute sp_addqreader_agent to create the Queue Reader Agent job. 
EXEC sp_addqreader_agent 
    @job_login = @login, 
    @job_password = @password;
GO

-- Execute at the Publisher.
USE [Northwind]
GO

DECLARE @publication AS sysname;
DECLARE @publicationDB AS sysname;
DECLARE @article AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publication = N'NwdProductTran';
SET @publicationDB = N'Northwind';
SET @article = N'Products';
-- Specify the Windows account to run the Log Reader and Snapshot Agents.
SET @login = $(Login); 
-- Pass the password at runtime.
SET @password = $(Password); 

-- Enable the replication 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 use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;

-- Add the transactional publication.
EXEC sp_addpublication 
    @publication = @publication, 
    @sync_method = N'native', 
    @repl_freq = N'continuous', 
    @status = N'active',
    @description = N'Transactional publication of Northwind.', 
    @allow_push = N'true', 
    @allow_pull = N'true', 
    @allow_sync_tran = N'true', 
    @autogen_sync_procs = N'true', 
    @allow_queued_tran = N'true',
    @replicate_ddl = 1,
    @enabled_for_p2p = N'false';

-- Create a new snapshot job for the publication, using a default schedule.
EXEC sp_addpublication_snapshot 
    @publication = @publication, 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;

-- Add a transactional article.
EXEC sp_addarticle 
  @publication = @publication, 
  @article = @article, 
  @source_owner = N'dbo', 
  @source_object = @article, 
  @destination_table = @article, 
  @type = N'logbased', 
  @schema_option = 0x00000000000080F3, 
  @ins_cmd = N'CALL sp_MSins_Products', 
  @del_cmd = N'XCALL sp_MSdel_Products', 
  @upd_cmd = N'XCALL sp_MSupd_Products', 
  @auto_identity_range = N'false',
  @identityrangemanagementoption = N'manual',
  @fire_triggers_on_snapshot = N'false';
GO

例

Customers テーブルのマージパブリケーションを作成するSQL Server 2000 スクリプトの例を次に示します。読みやすくするために、既定のパラメーターは削除されています。

-- Enable the replication database.
USE [Northwind]
GO

DECLARE @publicationDB AS sysname
DECLARE @publication AS sysname
DECLARE @article AS sysname
SET @publicationDB = N'Northwind' 
SET @publication = N'NwdCustomersMerge' 
SET @article = N'Customers' 

EXEC sp_replicationdboption 
    @dbname = @publicationDB, 
    @optname = N'merge publish', 
    @value = N'true'

-- Add the merge publication.
EXEC sp_addmergepublication 
    @publication = @publication, 
    @description = N'Merge publication of Northwind.', 
    @retention = 14, 
    @sync_mode = N'native', 
    @centralized_conflicts = N'true', 
    @dynamic_filters = N'false', 
    @keep_partition_changes = N'false'
 
EXEC sp_addpublication_snapshot 
    @publication = @publication

-- Add the merge articles.
EXEC sp_addmergearticle 
    @publication = @publication, 
    @article = @article, 
    @source_owner = N'dbo', 
    @source_object = @article, 
    @type = N'table', 
    @description = null, 
    @column_tracking = N'true', 
    @schema_option = 0x000000000000CFF1
 GO

例

2005 以降のバージョンで正常に実行されるようにアップグレードされたマージパブリケーションを作成する前のスクリプトの例SQL Server次に示します。新しいパラメーターの既定値は、明示的に宣言されています。

注意

Windows 資格情報は、 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".

-- Enabling the replication database
-- Enable the replication database.
USE [Northwind]
GO

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'Northwind';
SET @publication = N'NwdCustomersMerge';
SET @article = N'Customers';
-- Specify the Windows account to run the Snapshot Agent.
SET @login = $(Login); 
-- Supply the password at runtime.
SET @password = $(Password); 

EXEC sp_replicationdboption 
    @dbname = @publicationDB, 
    @optname = N'merge publish', 
    @value = N'true';

-- Add the merge publication.
EXEC sp_addmergepublication 
    @publication = @publication, 
    @description = N'Merge publication of Northwind.', 
    @retention = 14, 
    @sync_mode = N'native', 
    @dynamic_filters = N'false', 
    @keep_partition_changes = N'false',
    -- Only set to '90RTM' if all Subscribers are SQL Server 2005.
    @publication_compatibility_level = N'90RTM',
    @replicate_ddl = 1,
    @allow_subscriber_initiated_snapshot = N'true',
    @allow_web_synchronization = N'false',
    @allow_partition_realignment = N'true',
    @retention_period_unit = N'day',
    @automatic_reinitialization_policy = 0,
    @conflict_logging = N'both';
 
EXEC sp_addpublication_snapshot 
    @publication = @publication, 
    @job_login = @login,
    @job_password = @password;

-- Add the merge article.
EXEC sp_addmergearticle 
    @publication = @publication, 
    @article = @article, 
    @source_owner = N'dbo', 
    @source_object = @article, 
    @type = N'table', 
    @description = null, 
    @column_tracking = N'true', 
    @schema_option = 0x0000000000034FD1,
    @partition_options = 0,
    @subscriber_upload_options = 0,
    @identityrangemanagementoption = N'manual',
    @delete_tracking = N'true',
    @compensate_for_errors = N'false',
    @stream_blob_columns = N'true';
GO

例

トランザクションパブリケーションへのプッシュサブスクリプションを作成するSQL Server 2000 スクリプトの例を次に示します。読みやすくするために、既定のパラメーターは削除されています。

DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'NwdProductTran' 
SET @subscriber = N'MYSUBSERVER' 
SET @subscriptionDB = N'NorthwindReplica' 

-- Add a Subscriber, using the defaults.
USE [master]
EXEC sp_addsubscriber 
    @subscriber = @subscriber

-- Add a push subscription to a transactional publication.
USE [Northwind]
EXEC sp_addsubscription 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @destination_db = @subscriptionDB, 
    @subscription_type = N'push'
GO

例

トランザクションパブリケーションへのプッシュサブスクリプションを作成し、SQL Server 2005 以降のバージョンで正常に実行するようにアップグレードした前のスクリプトの例を次に示します。新しいパラメーターの既定値は、明示的に宣言されています。

注意

Windows 資格情報は、 sqlcmd スクリプト変数を使用して実行時に指定されます。

-- 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".

DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publication = N'NwdProductTran'; 
SET @subscriber = $(Subscriber); 
SET @subscriptionDB = N'NorthwindReplica'; 
-- Specify the Windows account to run the Distribution Agent.
SET @login = $(Login); 
-- Supply the password at runtime.
SET @password = $(Password); 

-- Add a push subscription to a transactional publication.
USE [Northwind]
EXEC sp_addsubscription 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @destination_db = @subscriptionDB, 
    @subscription_type = N'push';

-- Add an agent job to synchronize the push subscription.
EXEC sp_addpushsubscription_agent 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @subscriber_db = @subscriptionDB, 
    @job_login = @login, 
    @job_password = @password;
GO

例

マージパブリケーションへのプッシュサブスクリプションを作成するSQL Server 2000 スクリプトの例を次に示します。読みやすくするために、既定のパラメーターは削除されています。

DECLARE @publication AS sysname
DECLARE @subscriber AS sysname
DECLARE @subscriptionDB AS sysname
SET @publication = N'NwdCustomersMerge' 
SET @subscriber = N'SUBSERVER' 
SET @subscriptionDB = N'NorthwindReplica' 

-- Add a Subscriber, using the defaults.
USE [master]
EXEC sp_addsubscriber 
  @subscriber = @subscriber

-- Add a push subscription to a merge publication.
USE [Northwind]
EXEC sp_addmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB, 
  @subscription_type = N'push',
  @subscriber_type = N'local',
  @sync_type = N'automatic'
GO

例

次に、マージパブリケーションへのプッシュサブスクリプションを作成し、SQL Server 2005 以降のバージョンで正常に実行するようにアップグレードした前のスクリプトの例を示します。新しいパラメーターの既定値は、明示的に宣言されています。

注意

Windows 資格情報は、 sqlcmd スクリプト変数を使用して実行時に指定されます。

-- 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".

DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publication = N'NwdCustomersMerge'; 
SET @subscriber = $(Subscriber); 
SET @subscriptionDB = N'NorthwindReplica'; 
-- Specify the Windows account to run the Merge Agent.
SET @login = $(Login); 
-- Supply the password at runtime.
SET @password = $(Password); 

-- Add a push subscription to a merge publication.
USE [Northwind]
EXEC sp_addmergesubscription 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @subscriber_db = @subscriptionDB, 
    @subscription_type = N'push';

-- Add an agent job to synchronize the push subscription.
EXEC sp_addmergepushsubscription_agent 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @subscriber_db = @subscriptionDB, 
    @job_login = @login, 
    @job_password = @password;
GO

例

トランザクションパブリケーションへのプルサブスクリプションを作成するSQL Server 2000 スクリプトの例を次に示します。読みやすくするために、既定のパラメーターは削除されています。

DECLARE @publication AS sysname
DECLARE @subscriber AS sysname
DECLARE @subscriptionDB AS sysname
SET @publication = N'NwdCustomersMerge' 
SET @subscriber = N'SUBSERVER' 
SET @subscriptionDB = N'NorthwindReplica' 

-- Add a Subscriber, using the defaults.
USE [master]
EXEC sp_addsubscriber 
  @subscriber = @subscriber

-- Add a push subscription to a merge publication.
USE [Northwind]
EXEC sp_addmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB, 
  @subscription_type = N'push',
  @subscriber_type = N'local',
  @sync_type = N'automatic'
GO

例

次に、トランザクションパブリケーションへのプルサブスクリプションを作成し、SQL Server 2005 以降のバージョンで正常に実行するようにアップグレードした前のスクリプトの例を示します。新しいパラメーターの既定値は、明示的に宣言されています。

注意

Windows 資格情報は、 sqlcmd スクリプト変数を使用して実行時に指定されます。

-- 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".

-- Execute at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publication = N'NwdProductTran'; 
SET @publisher = $(Publisher); 
SET @publicationDB = N'Northwind'; 
-- Specify the Windows account to run the Distribution Agent.
SET @login = $(Login); 
-- Supply the password at runtime.
SET @password = $(Password); 

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [NorthwindReplica]
EXEC sp_addpullsubscription 
    @publisher = @publisher, 
    @publication = @publication, 
    @publisher_db = @publicationDB,
    @subscription_type = N'pull';

-- Add an agent job to synchronize the pull subscription.
EXEC sp_addpullsubscription_agent 
    @publisher = @publisher, 
    @publisher_db = @publicationDB, 
    @publication = @publication, 
    @distributor = @publisher,
    @job_login = @login,
    @job_password = @password;
GO

-- Execute at the Publisher.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'NwdProductTran'; 
SET @subscriber = $(Subscriber); 
SET @subscriptionDB = N'NorthwindReplica'; 

-- Add a pull subscription to a transactional publication.
USE [Northwind]
EXEC sp_addsubscription 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @destination_db = @subscriptionDB, 
    @subscription_type = N'pull';
GO

例

マージパブリケーションへのプルサブスクリプションを作成するSQL Server 2000 スクリプトの例を次に示します。読みやすくするために、既定のパラメーターは削除されています。

-- Execute at the Subscriber
DECLARE @publication AS sysname
DECLARE @publisher AS sysname
DECLARE @publicationDB AS sysname
DECLARE @subscriber AS sysname
DECLARE @subscriptionDB AS sysname
SET @publication = N'NwdCustomersMerge' 
SET @publisher = N'PUBSERVER' 
SET @publicationDB = N'Northwind' 
SET @subscriber = N'SUBSERVER' 
SET @subscriptionDB = N'NorthwindReplica'

-- At the subscription database, create a pull subscription 
-- to a merge publication.
USE [NorthwindReplica]
EXEC sp_addmergepullsubscription 
    @publisher = @publisher, 
    @publication = @publication, 
    @publisher_db = @publicationDB

-- Add an agent job to synchronize the pull subscription. 
EXEC sp_addmergepullsubscription_agent 
    @publisher = @publisher, 
    @publisher_db = @publicationDB, 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @subscriber_db = @subscriptionDB, 
    @distributor = @publisher
GO

-- Execute at the Publisher.
DECLARE @publication AS sysname
DECLARE @subscriber AS sysname
DECLARE @subscriptionDB AS sysname
SET @publication = N'NwdCustomersMerge' 
SET @subscriber = N'MYSUBSERVER' 
SET @subscriptionDB = N'NorthwindReplica' 

-- Add a Subscriber, using the defaults.
USE [master]
EXEC sp_addsubscriber 
  @subscriber = @subscriber

-- Add a pull subscription to a merge publication.
USE [Northwind]
EXEC sp_addmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB, 
  @subscription_type = N'pull',
  @subscriber_type = N'local',
  @sync_type = N'automatic'
GO

例

次に、マージパブリケーションへのプルサブスクリプションを作成し、SQL Server 2005 以降のバージョンで正常に実行するようにアップグレードした前のスクリプトの例を示します。新しいパラメーターの既定値は、明示的に宣言されています。

注意

Windows 資格情報は、 sqlcmd スクリプト変数を使用して実行時に指定されます。

-- 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".

-- Execute at the Subscriber
DECLARE @publication  AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publication = N'NwdCustomersMerge'; 
SET @publisher = $(Publisher); 
SET @publicationDB = N'Northwind'; 
-- Specify the Windows account to run the Merge Agent.
SET @login = $(Login); 
-- Pass the password at runtime.
SET @password = $(Password); 

-- At the subscription database, create a pull subscription 
-- to a merge publication.
USE [NorthwindReplica]
EXEC sp_addmergepullsubscription 
  @publisher = @publisher, 
  @publication = @publication, 
  @publisher_db = @publicationDB;

-- Add an agent job to synchronize the pull subscription. 
EXEC sp_addmergepullsubscription_agent 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication,
  @distributor = @publisher,
  @job_login = @login,
  @job_password = @password;
GO

-- Execute at the Publisher.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'NwdCustomersMerge';
SET @subscriber = $(Subscriber);
SET @subscriptionDB = N'NorthwindReplica';

-- Add a pull subscription to a merge publication.
USE [Northwind]
EXEC sp_addmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB, 
  @subscription_type = N'pull',
  @subscriber_type = N'local',
  @sync_type = N'automatic';
GO

参照

パブリケーションを作成する
 プッシュサブスクリプションを作成する
 Create a Pull Subscription
レプリケーションのセキュリティ設定の表示および変更
 MSSQL_ENG021797
MSSQL_ENG021798
Replication System Stored Procedures Concepts
レプリケートされたデータベースのアップグレード

次の方法で共有

レプリケーションスクリプトのアップグレード (レプリケーション Transact-SQL プログラミング)

スナップショットパブリケーションまたはトランザクションパブリケーションを構成するスクリプトをアップグレードするには

スナップショットパブリケーションまたはトランザクションパブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには

マージパブリケーションを構成するスクリプトをアップグレードするには

マージパブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには

例

例

例

例

例

例

例

例

例

例

例

例

参照

その他のリソース

次の方法で共有

レプリケーション スクリプトのアップグレード (レプリケーション Transact-SQL プログラミング)

スナップショット パブリケーションまたはトランザクション パブリケーションを構成するスクリプトをアップグレードするには

スナップショット パブリケーションまたはトランザクション パブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには

マージ パブリケーションを構成するスクリプトをアップグレードするには

マージ パブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには

例

例

例

例

例

例

例

例

例

例

例

例

参照

その他のリソース

レプリケーションスクリプトのアップグレード (レプリケーション Transact-SQL プログラミング)

スナップショットパブリケーションまたはトランザクションパブリケーションを構成するスクリプトをアップグレードするには

スナップショットパブリケーションまたはトランザクションパブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには

マージパブリケーションを構成するスクリプトをアップグレードするには

マージパブリケーションにサブスクリプションを追加するスクリプトをアップグレードするには