sp_reinitpullsubscription (Transact-SQL)

  • [アーティクル]

ディストリビューション エージェントの次回実行時に再初期化するように、トランザクション プル サブスクリプションまたは匿名サブスクリプションにマークを付けます。 このストアド プロシージャは、サブスクライバー側でプル サブスクリプション データベースについて実行されます。

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

構文

sp_reinitpullsubscription [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication'

引数

  • [ @publisher=] 'publisher'
    パブリッシャーの名前です。 publisher のデータ型は sysname で、既定値はありません。

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

  • [ @publication=] 'publication'
    パブリケーションの名前です。 publication のデータ型は sysname で、既定値は all です。これは、すべてのサブスクリプションに再初期化のマークを付けることを指定します。

戻り値

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

説明

sp_reinitpullsubscription は、トランザクション レプリケーションで使用します。

sp_reinitpullsubscription は、ピアツーピア トランザクション レプリケーションではサポートされていません。

sp_reinitpullsubscription をサブスクライバーから呼び出して、ディストリビューション エージェントの次回実行時にサブスクリプションを再初期化できます。

@immediate_sync の値を false に設定して作成されたパブリケーションへのサブスクリプションは、サブスクライバーから再初期化することはできません。

サブスクライバーで sp_reinitpullsubscription を、またはパブリッシャーで sp_reinitsubscription を実行することにより、プル サブスクリプションを再初期化できます。

使用例

-- 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 @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks2012';
SET @publication = N'AdvWorksProductTran';

USE [AdventureWorks2012Replica]

-- Execute at the Subscriber to reinitialize the pull subscription. 
EXEC sp_reinitpullsubscription 
    @publisher = $(PubServer),
    @publisher_db = @publicationDB,
    @publication = @publication;
GO

-- Start the Distribution Agent.

権限

sp_reinitpullsubscription を実行できるのは、固定サーバー ロール sysadmin または固定データベース ロール db_owner のメンバーだけです。

関連項目

参照

システム ストアド プロシージャ (Transact-SQL)

概念

サブスクリプションの再初期化

サブスクリプションの再初期化