sp_addqreader_agent (Transact-SQL)
指定したディストリビューターにキュー リーダー エージェントを追加します。 このストアド プロシージャは、ディストリビューター側でディストリビューション データベースについて実行されるか、パブリッシャー側でパブリケーション データベースについて実行されます。
.gif "トピック リンク アイコン")
構文
sp_addqreader_agent [ @job_login = ] 'job_login'
, [ @job_password = ] 'job_password'
[ , [ @job_name = ] 'job_name'
[ , [ @frompublisher = ] frompublisher
引数
[ @job_login= ] 'job_login'
エージェントを実行する Microsoft Windows アカウント用のログインを指定します。 job_login のデータ型は nvarchar(257) で、既定値はありません。 この Windows アカウントはディストリビューターへのエージェント接続で常に使用されます。[ @job_password= ] 'job_password'
エージェントを実行する Windows アカウント用のパスワードを指定します。 job_password のデータ型は sysname で、既定値はありません。.gif "セキュリティに関する注意")
セキュリティに関する注意スクリプト ファイルに認証情報を格納しないでください。 最大限のセキュリティを得るには、ログイン名とパスワードを実行時に指定します。
[ @job_name= ] 'job_name'
既存のエージェント ジョブの名前を指定します。 job_name のデータ型は sysname で、既定値は NULL です。 このパラメーターは、新しく作成したジョブ (既定値) の代わりに既存のジョブを使ってエージェントを作成するときにだけ指定します。[ @frompublisher= ] frompublisher
プロシージャをパブリッシャー側で実行するかどうかを指定します。 frompublisher のデータ型は bit で、既定値は 0 です。 値 1 は、プロシージャをパブリッシャー側でパブリケーション データベースについて実行することを示します。
戻り値
0 (成功) または 1 (失敗)
説明
sp_addqreader_agent は、トランザクション レプリケーションで使用します。
sp_addqreader_agent は、sp_adddistributiondb を実行してから sp_addpublication を実行するまでに、少なくとも 1 回、キュー更新がサポートされるディストリビューター側で実行する必要があります。
キュー リーダー エージェント ジョブは、sp_dropdistributiondb を実行すると削除されます。
権限
sp_addqreader_agent を実行できるのは、sysadmin 固定サーバー ロールのメンバーだけです。
関連項目
タスク
レプリケーション スクリプトのアップグレード (レプリケーション Transact-SQL プログラミング)
参照
sp_changeqreader_agent (Transact-SQL)
sp_helpqreader_agent (Transact-SQL)