sp_helpmergepullsubscription (Transact-SQL)
適用対象: 
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、 pull、 bothです。
結果セット
| 列名 | データ型 | 説明 |
|---|---|---|
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 = Push1 = Pull2 = 匿名 |
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を実行できます。