sp_helpmergepullsubscription (Transact-SQL)

適用対象: SQL サーバー

サブスクライバーに存在するプル サブスクリプションに関する情報を返します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

sp_helpmergepullsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
[ ; ]

引数

[ @publication = ] N'publication'

出版物の名前。 @publicationsysname で、既定値は % です。 @publication%されている場合は、現在のデータベース内のすべてのマージ パブリケーションとサブスクリプションに関する情報が返されます。

[ @publisher = ] N'publisher'

パブリッシャーの名前。 @publishersysname で、既定値は % です。

[ @publisher_db = ] N'publisher_db'

パブリッシャー データベースの名前。 @publisher_dbsysname で、既定値は % です。

[ @subscription_type = ] N'subscription_type'

プル サブスクリプションを表示するかどうかを指定します。 @subscription_typenvarchar(10) で、既定値は pull です。 有効な値は、 pushpullbothです。

結果セット

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

0 = 非アクティブなサブスクリプション

1 = アクティブなサブスクリプション

2 = 削除されたサブスクリプション

3 = デタッチされたサブスクリプション

4 = アタッチされたサブスクリプション

5 = サブスクリプションは、アップロードで再初期化のマークが付けられています

6 = サブスクリプションのアタッチに失敗しました

7 = バックアップから復元されたサブスクリプション
subscriber_type int サブスクライバーの種類:

1 = グローバル

2 = ローカル

3 = 匿名
subscription_type int サブスクリプションの種類:

0 = Push

1 = Pull

2 = 匿名
priority float(8) サブスクリプションの優先度。 値は 100.00未満にする必要があります。
sync_type tinyint サブスクリプション同期の種類:

1 = 自動

2 = スナップショットは使用されません。
description nvarchar (255) プル サブスクリプションの簡単な説明。
merge_jobid binary(16) マージ エージェントのジョブ ID。
enabled_for_syncmgr int Microsoft Synchronization Manager を使用してサブスクリプションを同期できるかどうかを指定します。
last_updated nvarchar(26) マージ エージェントが最後にサブスクリプションを正常に同期した時刻。
publisher_login sysname パブリッシャー のログイン名。
publisher_password sysname 発行元のパスワード。
publisher_security_mode int パブリッシャーのセキュリティ モードを指定します。

0 = SQL Server 認証

1 = Windows 認証
distributor sysname ディストリビューターの名前。
distributor_login sysname ディストリビューターのログイン名。
distributor_password sysname ディストリビューターのパスワード。
distributor_security_mode int ディストリビューターのセキュリティ モードを指定します。

0 = SQL Server 認証

1 = Windows 認証
ftp_address sysname 下位互換性のためにのみ使用できます。 ディストリビューターのファイル転送プロトコル (FTP) サービスのネットワーク アドレス。
ftp_port int 下位互換性のためにのみ使用できます。 ディストリビューターの FTP サービスのポート番号。
ftp_login sysname 下位互換性のためにのみ使用できます。 FTP サービスへの接続に使用するユーザー名。
ftp_password sysname 下位互換性のためにのみ使用できます。 FTP サービスへの接続に使用するユーザー パスワード。
alt_snapshot_folder nvarchar (255) 場所が既定の場所以外の場合、または既定の場所に加えて、スナップショット フォルダーが格納される場所。
working_directory nvarchar (255) そのオプションが指定されている場合に FTP を使用してスナップショット ファイルが転送されるディレクトリへの完全修飾パス。
use_ftp bit サブスクリプションはインターネット経由でパブリケーションをサブスクライブしており、FTP アドレス指定プロパティが構成されています。 0場合、サブスクリプションは FTP を使用していません。 1場合、サブスクリプションは FTP を使用しています。
offload_agent bit エージェントをアクティブ化してリモートで実行できるかどうかを指定します。 0場合、エージェントをリモートでアクティブ化することはできません。
offload_server sysname リモートから起動するときに使用するサーバーの名前です。
use_interactive_resolver int 調整時に対話型の競合回避モジュールを使用するかどうかを示します。 0場合、対話型リゾルバーは使用されません。
subid uniqueidentifier サブスクライバーの ID。
dynamic_snapshot_location nvarchar (255) スナップショット ファイルが保存されているフォルダーへのパス。
last_sync_status int 同期の状態:

1 = 開始中

2 = 成功

3 = 進行中

4 = アイドル

5 = 前のエラーの後の再試行

6 = 失敗

7 = 検証に失敗しました

8 = 成功した検証

9 = シャットダウンを要求しました
last_sync_summary sysname 最後の同期結果の説明。
use_web_sync bit サブスクリプションを HTTPS 経由で同期できるかどうかを指定します。ここで、 1 の値は、この機能が有効であることを意味します。
internet_url nvarchar(260) Web 同期のレプリケーション リスナーの場所を表す URL。
internet_login nvarchar(128) 基本認証を使用して Web 同期をホストしている Web サーバーに接続するときに、マージ エージェントが使用するログイン。
internet_password nvarchar(524) 基本認証を使用して Web 同期をホストしている Web サーバーに接続するときにマージ エージェントが使用するログインのパスワード。
internet_security_mode int Web 同期をホストしている Web サーバーに接続するときに使用される認証モード。 1の値は Windows 認証を意味し、0 の値は SQL Server 認証を意味します。
internet_timeout int Web 同期要求の有効期限が切れるまでの時間 (秒単位)。
hostname nvarchar(128) パラメーター化された行フィルターの WHERE 句でこの関数を使用する場合に、 HOST_NAME のオーバーロードされた値を指定します。
job_login nvarchar(512) マージ エージェントが実行される Windows アカウント。このアカウントは、 domain\username 形式で返されます。
job_password sysname セキュリティ上の理由から、 ** の値は常に返されます。

リターン コードの値

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

解説

sp_helpmergepullsubscription はマージ レプリケーションで使用されます。 結果セットでは、 last_updated で返される日付は yyyyMMdd hh:mm:ss.fffとして書式設定されます。

アクセス許可

sysadmin固定サーバー ロールとdb_owner固定データベース ロールのメンバーのみが、sp_helpmergepullsubscriptionを実行できます。