sp_helpmergesubscription (Transact-SQL)

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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

引数

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

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

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

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

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

[ @subscription_type = ] 'subscription_type' サブスクリプションの種類を指定します。 subscription_typenvarchar(15)であり、これらの値のいずれかを指定できます。

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

[ @found = ] 'found'OUTPUT 返される行を示すフラグです。 foundint で、OUTPUT パラメーターは既定値の NULL です。 1 は、パブリケーションが見つかった場合を示します。 0 は、パブリケーションが見つからない場合を示します。

結果セット

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

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

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

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

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

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

5 = 少なくとも 1 つのジョブが前のエラーの後に実行を試みようとしています

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

0 = プッシュ

1 = プル

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 は Microsoft SQL Server 認証を意味します。
subscriber_login sysname サブスクライバーのログイン名です。
subscriber_password sysname 実際のサブスクライバー パスワードは返されません。 結果は "******" 文字列でマスクされます。

リターン コードの値

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

解説

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

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

アクセス許可

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

参照

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