sp_MSchange_merge_agent_properties (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

SQL Server 2005 (9.x) 以降のバージョンのディストリビューターで実行されるマージ エージェント ジョブのプロパティを変更します。 このストアド プロシージャは、パブリッシャーが SQL Server 2000 (8.x) のインスタンスで実行されるときにプロパティを変更するために使用されます。 このストアド プロシージャは、ディストリビューション データベースのディストリビューターで実行されます。

Transact-SQL 構文表記規則

構文

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

引数

[ @publisher = ] N'publisher'

パブリッシャーの名前。 @publisherは sysname で、既定値はありません。

[ @publisher_db = ] N'publisher_db'

パブリケーション データベースの名前。 @publisher_dbは sysname で、既定値はありません。

[ @publication = ] N'publication'

出版物の名前。 @publicationは sysname で、既定値はありません。

[ @subscriber = ] N'subscriber'

サブスクライバーの名前。 @subscriberは sysname で、既定値はありません。

[ @subscriber_db = ] N'subscriber_db'

サブスクリプション データベースの名前。 @subscriber_dbは sysname で、既定値はありません。

[ @property = ] N'property'

変更するパブリケーション プロパティ。 @propertyは sysname で、既定値はありません。

[ @value = ] N'value'

新しいプロパティ値です。 @valueは nvarchar(524)で、既定値はありません。

次の表では、変更できるマージ エージェント ジョブのプロパティと、それらのプロパティの値の制限について説明します。

プロパティ 値 説明
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 (9.x) 以降のバージョンのインスタンスで実行されている場合は、sp_changemergesubscriptionを使用して、ディストリビューターで実行されるプッシュ サブスクリプションを同期するマージ エージェント ジョブのプロパティを変更する必要があります。

アクセス許可

ディストリビューターの sysadmin 固定サーバー ロールのメンバーのみが実行 sp_MSchange_merge_agent_propertiesできます。

関連するコンテンツ