sp_helpmergesubscription (Transact-SQL)
マージ パブリケーションへのサブスクリプション (プッシュ サブスクリプションとプル サブスクリプション) に関する情報を返します。 このストアド プロシージャは、パブリッシャー側でパブリケーション データベースについて実行されるか、再パブリッシュしているサブスクライバー側でサブスクリプション データベースについて実行されます。
.gif "トピック リンク アイコン")
構文
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'
サブスクライバーの名前を指定します。 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 (既定値)
プッシュ サブスクリプション
pull
プル サブスクリプション
both
プッシュおよびプル サブスクリプションの両方
[ @found=] 'found'OUTPUT
行を返すことを示すフラグです。 found のデータ型は int です。これは OUTPUT パラメーターの 1 つであり、既定値は NULL です。 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 = プッシュ 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 をサブスクライバー側で実行する必要があります。
権限
sp_helpmergesubscription を実行できるのは、sysadmin 固定サーバー ロール、db_owner 固定データベース ロール、またはサブスクリプションが属しているパブリケーションのパブリケーション アクセス リストのメンバーだけです。
関連項目
参照
sp_addmergesubscription (Transact-SQL)
sp_changemergesubscription (Transact-SQL)