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

2017-06-13

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

重要

sysadmin ロールのメンバーによって実行されるスクリプトをアップグレードする必要はありませんが、このトピックの説明に従って既存のスクリプトを変更することをお勧めします。レプリケーションエージェントのセキュリティモデルに関するトピックの「エージェントに必要なアクセス許可」セクションの説明に従って、各レプリケーションエージェントの最小アクセス許可を持つアカウントを指定します。

これらのセキュリティの強化により、レプリケーションエージェントジョブを実行する Microsoft Windows アカウントを明示的に指定できるようにすることで、アクセス許可をより詳細に制御できるようになり、既存のスクリプトの次のストアドプロシージャに影響します。

sp_addpublication_snapshot:

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

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

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

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

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

sp_addlogreader_agent (Transact-SQL) を実行してジョブを手動で追加し、ディストリビューターでログリーダーエージェントを実行する Windows 資格情報を指定する必要があります。 SQL Server 2005 より前のバージョンの 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 アカウントの要件については、「レプリケーションエージェントセキュリティモデル」を参照してください。

重要

可能な場合は、実行時にセキュリティ資格情報の入力をユーザーに求めます。スクリプトファイルに資格情報を格納する場合は、ファイル自体がセキュリティで保護されていることを確認します。

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

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

注

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

注

この手順は、キュー対応更新サブスクライバーをサポートするトランザクションパブリケーションでのみ必要です。
(省略可能) sp_addpublication (Transact-SQL) の実行を更新して、新しいレプリケーション機能を実装するパラメーターの既定値以外を設定します。
sp_addpublication (Transact-SQL) の後、パブリッシャー側のパブリケーションデータベースで sp_addpublication_snapshot (Transact-SQL) を実行します。 @publication と、@job_name および @job_password のスナップショットエージェントを実行する Windows 資格情報を指定します。エージェントがパブリッシャーへの接続時に 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、およびこのエージェントジョブのスケジュールを指定します。詳細については、「同期スケジュールの指定」を参照してください。これは、 sp_addsubscriptionの実行後に行われます。詳細については、「プッシュサブスクリプションの作成」を参照してください。

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

(省略可能)既存のスクリプトで、 sp_addmergepublication (Transact-SQL) の実行を更新して、新しいレプリケーション機能を実装するパラメーターの既定値以外を設定します。
sp_addmergepublication (Transact-SQL) の後、パブリッシャー側のパブリケーションデータベースで sp_addpublication_snapshot (Transact-SQL) を実行します。 @job_nameと@job_passwordに対してスナップショットエージェントを実行する@publicationと Windows 資格情報を指定します。エージェントがパブリッシャーへの接続時に 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、ディストリビューターのマージエージェントが実行される@job_nameと@job_passwordの Windows 資格情報、およびこのエージェントジョブのスケジュールを指定します。詳細については、「同期スケジュールの指定」を参照してください。これは、 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

例

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

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

こちらもご覧ください

パブリケーションを作成する
 プッシュサブスクリプションを作成する
 プルサブスクリプションを作成する
 レプリケーションのセキュリティ設定の表示と変更
 MSSQL_ENG021797
MSSQL_ENG021798
レプリケーションシステムストアドプロシージャの概念
 レプリケートされたデータベースのアップグレード

次の方法で共有

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

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

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

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

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

例

例

例

例

例

例

例

例

例

例

例

例

こちらもご覧ください

その他のリソース

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

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

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

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

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