次の方法で共有


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 のメンバーだけです。

関連項目

参照

sp_addmergepullsubscription (Transact-SQL)

sp_dropmergepullsubscription (Transact-SQL)

sp_helpmergepullsubscription (Transact-SQL)

システム ストアド プロシージャ (Transact-SQL)

概念

プル サブスクリプションのプロパティの表示または変更