sp_link_publication (Transact-SQL)

パブリッシャへの接続時に即時更新サブスクリプションの同期トリガが使用する、構成およびセキュリティ情報を設定します。このストアド プロシージャは、サブスクライバ側でサブスクリプション データベースについて実行されます。

セキュリティに関する注意セキュリティに関する注意

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

重要な注意事項重要

特定の条件下で、サブスクライバが Microsoft SQL Server 2005 Service Pack 1 以降を実行し、パブリッシャがそれより前のバージョンを実行している場合、このストアド プロシージャは失敗する可能性があります。このシナリオでストアド プロシージャが失敗する場合は、パブリッシャを SQL Server 2005 Service Pack 1 以降にアップグレードしてください。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_link_publication [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication' 
        , [ @security_mode = ] security_mode
    [ , [ @login = ] 'login' ]
    [ , [ @password = ]'password' ]
    [ , [ @distributor = ] 'distributor' ]

引数

  • [ @publisher= ] 'publisher'
    リンクするパブリッシャの名前です。publishersysname であり、既定値はありません。

  • [ @publisher_db= ] 'publisher_db'
    リンクするパブリッシャ データベースの名前です。publisher_dbsysname であり、既定値はありません。

  • [ @publication= ] 'publication'
    リンクするパブリケーションの名前です。publicationsysname であり、既定値はありません。

  • [ @security_mode= ] security_mode
    サブスクライバが即時更新のためにリモートのパブリッシャに接続するときに使用するセキュリティ モードです。security_modeint であり、次のいずれかの値をとります。可能な場合は、Windows 認証を使用します。

    説明

    0

    このストアド プロシージャで login および password として指定されたログインで SQL Server 認証を使用します。

    注意
    前のバージョンの SQL Server では、このオプションを使用して動的なリモート プロシージャ コール (RPC) を指定していました。

    1

    サブスクライバで変更を行うユーザーのセキュリティ コンテキスト (SQL Server 認証または Windows 認証) を使用します。

    注意
    パブリッシャ側でも、十分な権限を持つこのアカウントが必要です。Windows 認証を使用する場合は、セキュリティ アカウントの委任がサポートされる必要があります。

    2

    sp_link_publication で作成された既存のユーザー定義リンク サーバー ログインを使用します。

  • [ @login= ] 'login'
    ログイン名です。loginsysname であり、既定値は NULL です。このパラメータは、security_mode0 の場合に指定する必要があります。

  • [ @password= ] 'password'
    パスワードです。passwordsysname であり、既定値は NULL です。このパラメータは、security_mode0 の場合に指定する必要があります。

  • [ @distributor= ] 'distributor'
    ディストリビュータの名前です。distributorsysname であり、既定値は NULL です。

リターン コードの値

成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。

説明

sp_link_publication は、トランザクション レプリケーションで即時更新サブスクリプションによって使用されます。

sp_link_publication は、プッシュ サブスクリプションとプル サブスクリプションの両方に使用できます。サブスクリプション作成前、または作成後に呼び出すことができます。MSsubscription_properties (Transact-SQL) システム テーブルでは、エントリを挿入したり、エントリを更新できます。

プッシュ サブスクリプションのエントリは、sp_subscription_cleanup (Transact-SQL) でクリーンアップできます。プル サブスクリプションのエントリは、sp_droppullsubscription (Transact-SQL) または sp_subscription_cleanup (Transact-SQL) でクリーンアップできます。また、パスワードに NULL を指定して sp_link_publication を呼び出し、MSsubscription_properties (Transact-SQL) システム テーブル内のエントリを消去しておくとセキュリティ面で安心です。

即時更新サブスクライバがパブリッシャに接続するときに使用する既定モードでは、Windows 認証を使っての接続は許可されません。Windows 認証のモードを使って接続するには、パブリッシャに対してリンク サーバーを設定する必要があり、即時更新サブスクライバは、サブクライバを更新するときにこの接続を使用する必要があります。このためには、security_mode = 2 を指定して sp_link_publication を実行する必要があります。Windows 認証を使用する場合は、セキュリティ アカウントの委任がサポートされる必要があります。

使用例

-- 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 this batch at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publicationDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS nvarchar(512);
SET @publication = N'AdvWorksProductTran';
SET @publicationDB = N'AdventureWorks2008R2';
SET @publisher = $(PubServer);
SET @login = $(Login);
SET @password = $(Password);

-- At the subscription database, create a pull subscription to a transactional 
-- publication using immediate updating with queued updating as a failover.
EXEC sp_addpullsubscription 
    @publisher = @publisher, 
    @publication = @publication, 
    @publisher_db = @publicationDB, 
    @update_mode = N'failover', 
    @subscription_type = N'pull';

-- Add an agent job to synchronize the pull subscription, 
-- which uses Windows Authentication when connecting to the Distributor.
EXEC sp_addpullsubscription_agent 
    @publisher = @publisher, 
    @publisher_db = @publicationDB, 
    @publication = @publication,
    @job_login = @login,
    @job_password = @password; 

-- Add a Windows Authentication-based linked server that enables the 
-- Subscriber-side triggers to make updates at the Publisher. 
EXEC sp_link_publication 
    @publisher = @publisher, 
    @publication = @publication,
    @publisher_db = @publicationDB, 
    @security_mode = 0,
    @login = @login,
    @password = @password;
GO

USE AdventureWorks2008R2;
GO

-- Execute this batch at the Publisher.
DECLARE @publication AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @subscriptionDB = N'AdventureWorks2008R2Replica'; 
SET @subscriber = $(SubServer);

-- At the Publisher, register the subscription, using the defaults.
USE [AdventureWorks2008R2]
EXEC sp_addsubscription 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @destination_db = @subscriptionDB, 
    @subscription_type = N'pull', 
    @update_mode = N'failover';
GO

権限

sp_link_publication を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。