• [アーティクル]

sp_MSchange_merge_agent_properties (Transact-SQL)

Microsoft SQL Server 2005 以降のバージョンのディストリビュータで実行されるマージ エージェント ジョブのプロパティを変更します。このストアド プロシージャは、パブリッシャが SQL Server 2000 インスタンスで実行されている場合に、プロパティを変更するときに使用します。このストアド プロシージャは、ディストリビュータ側でディストリビューション データベースについて実行されます。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_MSchange_merge_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @publication = ] 'publication' 
        , [ @subscriber = ] 'subscriber' 
        , [ @subscriber_db = ] 'subscriber_db' 
        , [ @property = ] 'property' 
        , [ @value = ] 'value' ]

引数

  • [ @publisher = ] 'publisher'
    パブリッシャの名前を指定します。publisher のデータ型は sysname で、既定値はありません。

  • [ @publisher_db= ] 'publisher_db'
    パブリケーション データベースの名前を指定します。publisher_db のデータ型は sysname で、既定値はありません。

  • [ @publication = ] 'publication'
    パブリケーションの名前を指定します。publication のデータ型は sysname で、既定値はありません。

  • [ @subscriber= ] 'subscriber'
    サブスクライバの名前を指定します。subscriber のデータ型は sysname で、既定値はありません。

  • [ @subscriber_db= ] 'subscriber_db'
    サブスクリプション データベースの名前を指定します。subscriber_db のデータ型は sysname で、既定値はありません。

  • [ @property = ] 'property'
    変更するパブリケーション プロパティを指定します。property のデータ型は sysname で、既定値はありません。

  • [ @value = ] 'value'
    新しいプロパティ値を指定します。value のデータ型は nvarchar(524) で、既定値は NULL です。

    次の表は、変更できるマージ エージェント ジョブのプロパティと、プロパティの値に関する制限です。

    プロパティ

    値

    説明

    description

    サブスクリプションの簡単な説明。

    merge_job_login

    エージェントを実行する Microsoft Windows アカウントのログイン。

    merge_job_password

    エージェント ジョブを実行する Windows アカウントのパスワード。

    publisher_login

    サブスクリプションの同期で、パブリッシャに接続するときに使用するログイン。

    publisher_password

    パブリッシャのパスワード。

    空白のパスワードは使用しないでください。強力なパスワードを使用してください。

    publisher_security_mode

    1

    Windows 認証。

    可能な場合は、Windows 認証を使用します。

    0

    SQL Server 認証。

    subscriber_login

    サブスクリプションの同期で、サブスクライバに接続するときに使用するログイン。

    subscriber_password

    サブスクライバのパスワード。

    空白のパスワードは使用しないでください。強力なパスワードを使用してください。

    subscriber_security_mode

    1

    Windows 認証。

    可能な場合は、Windows 認証を使用します。

    0

    SQL Server 認証。
    注意注

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

戻り値

0 (成功) または 1 (失敗)

説明

sp_MSchange_merge_agent_properties は、マージ レプリケーションで使用します。

パブリッシャが SQL Server 2005 以降のバージョンのインスタンスで実行されている場合、ディストリビュータで実行されているプッシュ サブスクリプションを同期するマージ エージェント ジョブのプロパティを変更するには、sp_changemergesubscription を使用します。

権限

sp_MSchange_merge_agent_properties を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。