sp_helpmergepullsubscription (Transact-SQL)

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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

引数

[ @publication = ] N'publication'

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

[ @publisher = ] N'publisher'

パブリッシャーの名前。 @publisherは sysname で、既定値は %.

[ @publisher_db = ] N'publisher_db'

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

[ @subscription_type = ] N'subscription_type'

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

結果セット

列名 データ型 説明
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 アドレス指定プロパティが構成されています。 サブスクリプションで FTP が使用されていない場合 0。 サブスクリプションで FTP が使用されている場合 1
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 サーバーに接続するときに使用される認証モード。 値は Windows 認証を 1 意味し、値は SQL Server 認証を 0 意味します。
internet_timeout int Web 同期要求の有効期限が切れるまでの時間 (秒単位)。
hostname nvarchar(128) パラメーター化された行フィルターの WHERE 句でこの関数を使用する場合に、HOST_NAMEのオーバーロードされた値を指定します。
job_login nvarchar(512) マージ エージェントが実行される Windows アカウント。doメイン\username の形式で返されます。
job_password sysname セキュリティ上の理由から、値は ** 常に返されます。

リターン コードの値

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

解説

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

アクセス許可

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