sp_MSchange_distribution_agent_properties (Transact-SQL)

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

  
sp_MSchange_distribution_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' サブスクライバーの名前です。 サブスクライバー は sysname で、既定値はありません。

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

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

[ @value = ] 'value' 新しいプロパティ値です。 値 は nvarchar(524)、既定値は NULL です。

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

プロパティ	値	説明
distrib_job_login		エージェントが実行されている Microsoft Windows アカウントにログインします。
distrib_job_password		エージェント ジョブを実行する Windows アカウントのパスワード。
subscriber_catalog		OLE DB プロバイダーへの接続時に使用するカタログ。 このプロパティは、SQL Server 以外のサブスクライバーに対してのみ有効です。
subscriber_datasource		OLE DB プロバイダーで認識されるデータ ソースの名前。 このプロパティは、SQL Server 以外のサブスクライバーに対してのみ有効です。
subscriber_location		OLE DB プロバイダーによって認識されるデータベースの場所。 このプロパティは、SQL Server 以外のサブスクライバーに対してのみ有効です。
subscriber_login		サブスクライバーに接続してサブスクリプションを同期するときに使用するログイン。
subscriber_password		サブスクライバー のパスワード。 空白のパスワードは使用しないでください。 強力なパスワードを使用してください。
subscriber_provider		SQL Server 以外のデータ ソースの OLE DB プロバイダーが登録されている一意のプログラム識別子 (PROGID)。 このプロパティは、SQL Server 以外のサブスクライバーに対してのみ有効です。
subscriber_providerstring		データ ソースを識別する OLE DB プロバイダー固有の接続文字列。 このプロパティは、SQL Server 以外のサブスクライバーに対してのみ有効です。
subscriber_security_mode	1	Windows 認証 可能な場合は、Windows 認証を使用します。
	0	SQL Server 認証。
subscriber_type	0	SQL Server サブスクライバー
	1	ODBC データ ソース サーバー
	3	OLE DB プロバイダー
subscriptionstreams		変更のバッチをサブスクライバーに並列的に適用するために、ディストリビューション エージェントごとに許可される接続の数を表します。 SQL Server 以外のサブスクライバー、Oracle パブリッシャー、またはピアツーピア サブスクリプションではサポートされていません。

Note

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

リターン コードの値

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

解説

sp_MSchange_distribution_agent_propertiesは、スナップショット レプリケーションとトランザクション レプリケーションで使用されます。

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

アクセス許可

sp_MSchange_distribution_agent_propertiesを実行できるのは、ディストリビューターの sysadmin 固定サーバー ロールのメンバーだけです。

参照

sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)