sp_changemergepullsubscription (Transact-SQL)
適用対象: SQL Server
マージ プル サブスクリプションのプロパティを変更します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。
構文
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
を実行できます。