sp_helpmergepullsubscription (Transact-SQL)
サブスクライバーに存在するプル サブスクリプションに関する情報を返します。 このストアド プロシージャは、サブスクライバー側でサブスクリプション データベースについて実行されます。
.gif "トピック リンク アイコン")
構文
sp_helpmergepullsubscription [ [ @publication=] 'publication']
[ , [ @publisher=] 'publisher']
[ , [ @publisher_db=] 'publisher_db']
[ , [ @subscription_type=] 'subscription_type']
引数
[ @publication=] 'publication'
パブリケーションの名前です。 publication のデータ型は sysname で、既定値は % です。 publication が % である場合は、現在のデータベース内のすべてのマージ パブリケーションおよびサブスクリプションに関する情報が返されます。[ @publisher=] 'publisher'
パブリッシャーの名前です。 publisher のデータ型は sysname で、既定値は % です。[ @publisher_db=] 'publisher_db'
パブリッシャー データベースの名前です。 publisher_db のデータ型は sysname で、既定値は % です。[ @subscription_type=] 'subscription_type'
プル サブスクリプションを表示するかどうかを指定します。 subscription_type のデータ型は nvarchar(10) で、既定値は 'pull' です。 有効な値は、'push'、'pull'、'both' のいずれかです。
結果セット
列名 |
データ型 |
説明 |
|---|---|---|
subscription_name |
nvarchar(1000) |
サブスクリプションの名前。 |
publication |
sysname |
パブリケーションの名前。 |
publisher |
sysname |
パブリッシャーの名前。 |
publisher_db |
sysname |
パブリッシャー データベースの名前です。 |
subscriber |
sysname |
サブスクライバーの名前です。 |
subscription_db |
sysname |
サブスクリプション データベース名です。 |
status |
int |
サブスクリプションのステータスです。 0 = 非アクティブなサブスクリプション 1 = アクティブなサブスクリプション 2 = 削除されたサブスクリプション 3 = デタッチされたサブスクリプション 4 = アタッチされたサブスクリプション 5 = アップロードと共に再初期化するためにマークされているサブスクリプション 6 = 失敗したサブスクリプションをアタッチ中 7 = バックアップから復元されたサブスクリプション |
subscriber_type |
int |
サブスクライバーの種類です。 1 = グローバル 2 = ローカル 3 = 匿名 |
subscription_type |
int |
サブスクリプションの種類です。 0 = プッシュ 1 = プル 2 = 匿名 |
priority |
float(8) |
サブスクリプションの優先度です。 値は 100.00 未満でなければなりません。 |
sync_type |
tinyint |
サブスクリプションの同期タイプです。 1 = 自動同期 2 = スナップショットを使用しない |
description |
nvarchar(255) |
プル サブスクリプションの簡単な説明です。 |
merge_jobid |
binary(16) |
マージ エージェントのジョブ ID です。 |
enabled_for_syncmgr |
int |
Microsoft 同期マネージャーを介してサブスクリプションの同期が可能かどうかを指定します。 |
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 形式で返されます。
権限
sp_helpmergepullsubscription を実行できるのは、固定サーバー ロール sysadmin および固定データベース ロール db_owner のメンバーだけです。
関連項目
参照
sp_addmergepullsubscription (Transact-SQL)
sp_changemergepullsubscription (Transact-SQL)