sp_helpmergesubscription (Transact-SQL)
適用対象: 
SQL Server
プッシュとプルの両方で、マージ パブリケーションへのサブスクリプションに関する情報を返します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースまたはサブスクリプション データベースの再発行サブスクライバーで実行されます。
構文
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)であり、これらの値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
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 = Push1 = Pull2 = 両方 |
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実行できます。