sp_helpmergesubscription (Transact-SQL)

  • [アーティクル]

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

トピック リンク アイコン 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'
    パブリケーションの名前です。 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)

sp_dropmergesubscription (Transact-SQL)

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