sp_helpmergesubscription (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

プッシュとプルの両方で、マージ パブリケーションへのサブスクリプションに関する情報を返します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースまたはサブスクリプション データベースの再発行サブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

sp_helpmergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

引数

[ @publication = ] N'publication'

出版物の名前。 @publicationは sysname で、既定値は %. パブリケーションは既に存在し、識別子の規則 に準拠している必要があります。 またはNULL%、現在のデータベース内のすべてのマージ パブリケーションとサブスクリプションに関する情報が返されます。

[ @subscriber = ] N'subscriber'

サブスクライバーの名前。 @subscriberは sysname で、既定値は %. 指定されたパブリケーションに対するすべてのサブスクリプションに関する情報が返される場合 NULL 、または %指定したパブリケーションに関する情報が返されます。

[ @subscriber_db = ] N'subscriber_db'

サブスクリプション データベースの名前。 @subscriber_dbは sysname で、既定値は %、すべてのサブスクリプション データベースに関する情報を返します。

[ @publisher = ] N'publisher'

パブリッシャーの名前。 @publisherは sysname で、既定値は %、既定値は %、すべてのパブリッシャーに関する情報を返します。 パブリッシャーは有効なサーバーである必要があります。

[ @publisher_db = ] N'publisher_db'

パブリッシャー データベースの名前。 @publisher_dbは sysname で、既定値は %、すべてのパブリッシャー データベースに関する情報を返します。

[ @subscription_type = ] N'subscription_type'

サブスクリプションの種類。 @subscription_typeは nvarchar(15)で、これらの値のいずれかを指定できます。

値 説明
push (既定値) プッシュ サブスクリプション
pull プル サブスクリプション
both プッシュおよびプル サブスクリプションの両方

[ @found = ] foundOUTPUT

返される行を示すフラグ。 @foundは int 型の OUTPUT パラメーターです。

  • 1 は、パブリケーションが見つかったかどうかを示します。
  • 0 は、パブリケーションが見つからないことを示します。

結果セット

列名 データ型 説明
subscription_name sysname サブスクリプションの名前。
publication sysname パブリケーションの名前。
publisher sysname パブリッシャーの名前。
publisher_db sysname パブリッシャー データベースの名前。
subscriber sysname サブスクライバーの名前。
subscriber_db sysname サブスクリプション データベースの名前。
status int サブスクリプションの状態:

0 = すべてのジョブが開始を待機しています

1 = 1 つ以上のジョブが開始中

2 = すべてのジョブが正常に実行されました

3 = 少なくとも 1 つのジョブが実行されている

4 = すべてのジョブがスケジュールされ、アイドル状態になっている

5 = 前回の失敗後に少なくとも 1 つのジョブの実行が試行されている

6 = 少なくとも 1 つのジョブが正常に実行に失敗しました
subscriber_type int サブスクライバーの種類。
subscription_type int サブスクリプションの種類:

0 = Push

1 = Pull

2 = 両方
priority float(8) サブスクリプションの優先度を示す番号。
sync_type tinyint サブスクリプションの同期の種類。
description nvarchar (255) マージ サブスクリプションの簡単な説明。
merge_jobid binary(16) マージ エージェントのジョブ ID。
full_publication tinyint サブスクリプションが完全パブリケーションかフィルター選択パブリケーションかを指定します。
offload_enabled bit レプリケーション エージェントのオフロード実行がサブスクライバーで実行されるように設定されているかどうかを指定します。 の場合 NULL、実行はパブリッシャーで実行されます。
offload_server sysname エージェントが動作しているサーバーの名前。
use_interactive_resolver int 調整時に対話型の競合回避モジュールを使用するかどうかを示します。 この場合 0、対話型リゾルバーは使用されません。
hostname sysname サブスクリプションがHOST_NAME関数の値によってフィルター処理されるときに指定される値。
subscriber_security_mode smallint サブスクライバーのセキュリティ モード。Windows 1 認証を意味し 0 、SQL Server 認証を意味します。
subscriber_login sysname サブスクライバーのログイン名。
subscriber_password sysname 実際のサブスクライバー パスワードは返されません。 結果は文字列によって ****** マスクされます。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

sp_helpmergesubscription は、パブリッシャーまたは再パブリッシュサブスクライバーに格納されているサブスクリプション情報を返すためにマージ レプリケーションで使用されます。

匿名サブスクリプションの場合、 subscription_type値は常に 1 (プル) です。 ただし、匿名サブスクリプションに関する情報については、サブスクライバーでsp_helpmergepullsubscriptionを実行する必要があります。

アクセス許可

sysadmin 固定サーバー ロール、db_owner固定データベース ロール、またはサブスクリプションが属するパブリケーションのパブリケーション アクセス リストのメンバーのみが実行sp_helpmergesubscriptionできます。

関連するコンテンツ