sp_MSchange_distribution_agent_properties (Transact-SQL)
適用対象: SQL サーバー
Microsoft SQL Server 2005 (9.x) 以降のバージョンのディストリビューターで実行されるディストリビューション エージェント ジョブのプロパティを変更します。 このストアド プロシージャは、パブリッシャーが SQL Server 2000 (8.x) のインスタンスで実行されるときにプロパティを変更するために使用されます。 このストアド プロシージャは、ディストリビューション データベースのディストリビューターで実行されます。
構文
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'
サブスクライバーの名前です。 subscriber は sysname で、既定値はありません。
[ @subscriber_db = ] 'subscriber_db'
サブスクリプション データベースの名前を指定します。 subscriber_db は sysname で、既定値はありません。
[ @property = ] 'property'
変更するパブリケーション プロパティです。 property は sysname で、既定値はありません。
[ @value = ] 'value'
新しいプロパティ値です。 value は nvarchar(524) で、既定値は NULL です。
次の表では、変更できるディストリビューション エージェント ジョブのプロパティと、それらのプロパティの値の制限について説明します。
プロパティ | 値 | 説明 |
---|---|---|
distrib_job_login | エージェントが実行されている Microsoft Windows アカウントにログインします。 | |
distrib_job_password | エージェント ジョブを実行する Windows アカウントのパスワード。 | |
subscriber_catalog | OLE DB プロバイダーへの接続時に使用するカタログ。 このプロパティは、SQL Server Subscribers 以外の場合にのみ有効です。 | |
subscriber_datasource | OLE DB プロバイダーで認識されるデータ ソースの名前。 このプロパティは、SQL Server Subscribers 以外の場合にのみ有効です。 | |
subscriber_location | OLE DB プロバイダーによって認識されるデータベースの場所。 このプロパティは、SQL Server Subscribers 以外の場合にのみ有効です。 | |
subscriber_login | サブスクライバーに接続してサブスクリプションを同期するときに使用するログイン。 | |
subscriber_password | サブスクライバー のパスワード。 空白のパスワードは使用しないでください。 強力なパスワードを使用してください。 |
|
subscriber_provider | SQL Server 以外のデータ ソースの OLE DB プロバイダーが登録されている一意のプログラム識別子 (PROGID)。 このプロパティは、SQL Server Subscribers 以外の場合にのみ有効です。 | |
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を使用して、ディストリビューターで実行されるプッシュ サブスクリプションを同期するマージ エージェント ジョブのプロパティを変更する必要があります。
アクセス許可
sysadminディストリビューターの固定サーバー ロールのメンバーのみが、sp_MSchange_distribution_agent_propertiesを実行できます。
参照
sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)