sp_changemergepullsubscription (Transact-SQL)

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

トピック リンク アイコン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 のメンバだけです。