sp_helpmergesubscription (Transact-SQL)
適用対象:
SQL Server
プッシュとプルの両方で、マージ パブリケーションへのサブスクリプションに関する情報を返します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースまたはサブスクリプション データベースの再発行サブスクライバーで実行されます。
構文
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' パブリケーションの名前を指定します。 publication は sysname で、既定値は %です。 パブリケーションは既に存在し、識別子の規則に準拠している必要があります。 NULL または %の場合、現在のデータベース内のすべてのマージ パブリケーションとサブスクリプションに関する情報が返されます。
[ @subscriber = ] 'subscriber' サブスクライバーの名前を指定します。 サブスクライバー は sysname で、既定値は %です。 NULL または %の場合、指定されたパブリケーションのすべてのサブスクリプションに関する情報が返されます。
[ @subscriber_db = ] 'subscriber_db' サブスクリプション データベースの名前を指定します。 subscriber_dbは sysname で、既定値は %であり、すべてのサブスクリプション データベースに関する情報を返します。
[ @publisher = ] 'publisher' パブリッシャーの名前を指定します。 パブリッシャーは有効なサーバーである必要があります。 publisherは sysname で、既定値は %で、すべてのパブリッシャーに関する情報を返します。
[ @publisher_db = ] 'publisher_db' パブリッシャー データベースの名前を指定します。 publisher_dbは sysname で、既定値は %で、すべてのパブリッシャー データベースに関する情報を返します。
[ @subscription_type = ] 'subscription_type' サブスクリプションの種類を指定します。 subscription_typeは nvarchar(15)であり、これらの値のいずれかを指定できます。
| 値 | [説明] |
|---|---|
| push (既定値) | プッシュ サブスクリプション |
| プル | プル サブスクリプション |
| 両方 | プッシュおよびプル サブスクリプションの両方 |
[ @found = ] 'found'OUTPUT 返される行を示すフラグです。 foundは int で、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)