次の方法で共有

sp_helpmergesubscription (Transact-SQL)

  • [アーティクル]

適用対象: SQL サーバー

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

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 で、既定値は % です。 パブリケーションは既に存在し、 identifiers の規則に準拠している必要があります。 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)であり、これらの値のいずれかを指定できます。

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

[ @found = ] found OUTPUT

返される行を示すフラグ。 @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 サブスクライバーのセキュリティ モード。 1 は Windows 認証を意味し、 0 は SQL Server 認証を意味します。
subscriber_login sysname サブスクライバーのログイン名。
subscriber_password sysname 実際のサブスクライバー パスワードは返されません。 結果は、 ****** 文字列によってマスクされます。

リターン コードの値

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

解説

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

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

アクセス許可

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

関連するコンテンツ