sp_changemergepullsubscription (Transact-SQL)
マージ プル サブスクリプションのプロパティを変更します。 このストアド プロシージャは、サブスクライバー側でサブスクリプション データベースについて実行されます。
構文
sp_changemergepullsubscription [ [ @publication= ] 'publication' ]
[ , [ @publisher= ] 'publisher' ]
[ , [ @publisher_db= ] 'publisher_db' ]
[ , [ @property= ] 'property' ]
[ , [ @value= ] 'value' ]
引数
[ @publication=] 'publication'
パブリケーションの名前です。 publication のデータ型は sysname で、既定値は % です。[ @publisher=] 'publisher'
パブリッシャーの名前です。 publisher のデータ型は sysname で、既定値は % です。[ @publisher_db=] 'publisher_db'
パブリッシャー データベースの名前です。 publisher_db のデータ型は sysname で、既定値は % です。[ @property=] 'property'
変更するプロパティの名前を指定します。 property のデータ型は sysname で、表に記載されているいずれかの値を指定できます。[ @value=] 'value'
対象となるプロパティの新しい値を指定します。 value のデータ型は nvarchar(255) で、表に記載されているいずれかの値を指定できます。プロパティ
値
説明
alt_snapshot_folder
スナップショット フォルダーが既定の場所以外、または既定の場所に加えて保存されている場合の格納場所です。
description
このマージ プル サブスクリプションの説明です。
distributor
ディストリビューターの名前です。
distributor_login
ディストリビューターで使用する SQL Server 認証用のログイン ID です。
distributor_password
ディストリビューターで使用する SQL Server 認証用の (暗号化されている) パスワードです。
distributor_security_mode
1
ディストリビューターに接続するときに、Windows 認証を使用します。
0
ディストリビューターに接続するときに、SQL Server 認証を使用します。
dynamic_snapshot_location
スナップショット ファイルが保存されるフォルダーへのパスです。
ftp_address
旧バージョンとの互換性のためにだけ用意されています。 ディストリビューター用のファイル転送プロトコル (FTP) サービスのネットワーク アドレスです。
ftp_login
旧バージョンとの互換性のためにだけ用意されています。 FTP サービスに接続するときに使用するユーザー名です。
ftp_password
旧バージョンとの互換性のためにだけ用意されています。 FTP サービスに接続するときに使用するユーザー パスワードです。
ftp_port
旧バージョンとの互換性のためにだけ用意されています。 ディストリビューター用の FTP サービスのポート番号です。
hostname
HOST_NAME() 関数を結合フィルターまたは論理レコードのリレーションシップの WHERE 句で使用するときの、この関数の値を指定します。
internet_login
基本認証を使用して Web 同期をホストしている Web サーバーに接続するときにマージ エージェントが使用するログインです。
internet_password
基本認証を使用して Web 同期をホストしている Web サーバーに接続するときにマージ エージェントが使用するログインのパスワードです。
internet_security_mode
1
Web 同期をホストしている Web サーバーに接続するときに、Windows 認証を使用します。
0
Web 同期をホストしている Web サーバーに接続するときに、基本認証を使用します。
internet_timeout
Web 同期の要求期限が切れるまでの期間 (秒) です。
internet_url
Web 同期に対するレプリケーション リスナーの位置を表す URL。
merge_job_login
エージェントを実行する Windows アカウントのログイン。
merge_job_password
エージェントの実行で使用する Windows アカウントのパスワードです。
priority
旧バージョンとの互換性を保つためにだけ用意されています。通常と異なり、パブリッシャー側で sp_changemergesubscription を実行してサブスクリプションの優先度を変更します。
publisher_login
パブリッシャーで使用する SQL Server 認証用のログイン ID です。
publisher_password
パブリッシャーで使用する SQL Server 認証用の (暗号化されている) パスワードです。
publisher_security_mode
0
パブリッシャーに接続するときに、SQL Server 認証を使用します。
1
パブリッシャーに接続するときに、Windows 認証を使用します。
2
同期トリガーで静的な sysservers エントリを使用してリモート プロシージャ コール (RPC) を実行します。パブリッシャーは sysservers テーブルでリモート サーバーまたはリンク サーバーとして定義されている必要があります。
sync_type
automatic
パブリッシュされたテーブルのスキーマと初期データが最初にサブスクライバーに転送されます。
none
パブリッシュされたテーブルのスキーマと初期データは既にサブスクライバーにあります。システム テーブルとデータは常に転送されます。
use_ftp
true
通常のプロトコルの代わりに FTP を使用してスナップショットを取得します。
false
通常のプロトコルを使用してスナップショットを取得します。
use_web_sync
true
サブスクリプションは HTTP 上で同期できます。
false
サブスクリプションは HTTP 上で同期できません。
use_interactive_resolver
true
調整時にインタラクティブ競合回避モジュールを使用します。
false
インタラクティブ競合回避モジュールを使用しません。
working_directory
該当するオプションが指定され、FTP を使ってスナップショット ファイルを転送する場合の、転送先のディレクトリの完全修飾パスです。
NULL (既定値)
property 用にサポートされている値の一覧を返します。
戻り値
成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。
説明
sp_changemergepullsubscription は、マージ レプリケーションで使用します。
現在のサーバーがサブスクライバー、現在のデータベースがサブスクライバー データベースであると解釈されます。
エージェントのログインまたはパスワードを変更したら、エージェントを停止して再起動し、変更を反映させる必要があります。
権限
sp_changemergepullsubscription を実行できるのは、固定サーバー ロール sysadmin または固定データベース ロール db_owner のメンバーだけです。
関連項目
参照
sp_addmergepullsubscription (Transact-SQL)
sp_dropmergepullsubscription (Transact-SQL)
sp_helpmergepullsubscription (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)