sp_changemergepullsubscription (Transact-SQL)

適用対象:SQL Server

マージ プル サブスクリプションのプロパティを変更します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

sp_changemergepullsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

引数

[ @publication = ] N'publication'

出版物の名前。 @publicationは sysname で、既定値は %.

[ @publisher = ] N'publisher'

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

[ @publisher_db = ] N'publisher_db'

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

[ @property = ] N'property'

変更するプロパティの名前。 @propertyは sysname であり、次の表のいずれかの値を指定できます。

[ @value = ] N'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		結合フィルターまたは論理レコードリレーションシップの句でこの関数をWHERE使用する場合の値HOST_NAME()を指定します。
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 はマージ レプリケーションで使用されます。

現在のサーバーがサブスクライバー、現在のデータベースがサブスクライバー データベースであると解釈されます。

エージェントのログインまたはパスワードを変更した後、変更を有効にするには、エージェントを停止して再起動する必要があります。

アクセス許可

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

関連するコンテンツ

• プル サブスクリプションのプロパティの表示または変更
• sp_addmergepullsubscription (Transact-SQL)
• sp_dropmergepullsubscription (Transact-SQL)
• sp_helpmergepullsubscription (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)