sp_addqreader_agent (Transact-SQL)
指定したディストリビュータにキュー リーダー エージェントを追加します。このストアド プロシージャは、ディストリビュータ側でディストリビューション データベースについて実行されるか、パブリッシャ側でパブリケーション データベースについて実行されます。
構文
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 で、既定値はありません。セキュリティ メモ : スクリプト ファイルに認証情報を格納しないでください。最大限のセキュリティを得るには、ログイン名とパスワードを実行時に指定します。
- [ @job_name= ] 'job_name'
既存のエージェント ジョブの名前を指定します。job_name のデータ型は sysname で、既定値は NULL です。このパラメータは、新しく作成したジョブ (既定値) の代わりに既存のジョブを使ってエージェントを作成するときにだけ指定します。
- [ @frompublisher= ] frompublisher
プロシージャをパブリッシャ側で実行するかどうかを指定します。frompublisher のデータ型は bit で、既定値は 0 です。値 1 は、プロシージャをパブリッシャ側でパブリケーション データベースについて実行することを示します。
解説
sp_addqreader_agent は、トランザクション レプリケーションで使用します。
sp_addqreader_agent は、sp_adddistributiondb を実行してから sp_addpublication を実行するまでに、少なくとも 1 回、キュー更新がサポートされるディストリビュータ側で実行する必要があります。
キュー リーダー エージェント ジョブは、sp_dropdistributiondb を実行すると削除されます。
権限
sp_addqreader_agent を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。
戻り値
0 (成功) または 1 (失敗)
参照
関連項目
sp_changeqreader_agent (Transact-SQL)
sp_helpqreader_agent (Transact-SQL)
その他の技術情報
トランザクション パブリケーションに対するサブスクリプションの更新を有効にする方法 (レプリケーション Transact-SQL プログラミング)
レプリケーション スクリプトをアップグレードする方法 (レプリケーション Transact-SQL プログラミング)
トランザクション レプリケーションの更新可能なサブスクリプション