sp_addqreader_agent (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

特定のディストリビューターのキュー リーダー エージェントを追加します。 このストアド プロシージャは、ディストリビューション データベースのディストリビューターまたはパブリケーション データベースのパブリッシャーで実行されます。

Transact-SQL 構文表記規則

構文

sp_addqreader_agent
    [ [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @frompublisher = ] frompublisher ]
[ ; ]

引数

[ @job_login = ] N'job_login'

エージェントが実行される Microsoft Windows アカウントのログイン。 @job_loginは nvarchar(257) で、既定値は NULL. この Windows アカウントは、ディストリビューターへのエージェント接続に常に使用されます。

[ @job_password = ] N'job_password'

エージェントが実行される Windows アカウントのパスワード。 @job_passwordは sysname で、既定値はありません。

重要

認証情報はスクリプト ファイルに格納しないでください。 セキュリティを最大限に高めるには、実行時にログイン名とパスワードを指定する必要があります。

[ @job_name = ] N'job_name'

既存のエージェント ジョブの名前。 @job_nameは sysname で、既定値は NULL. このパラメーターは、新しく作成されたジョブ (既定値) ではなく、既存のジョブを使用してエージェントを作成する場合にのみ指定されます。

[ @frompublisher = ] frompublisher

プロシージャをパブリッシャーで実行するかどうかを指定します。 @frompublisherはビットで、既定値は 0.

値は 1 、プロシージャがパブリッシャーからパブリケーション データベース上で実行されていることを意味します。

リターン コードの値

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

解説

sp_addqreader_agent はトランザクション レプリケーションで使用されます。

sp_addqreader_agentは、sp_adddistributiondb後、sp_addpublication前のキュー更新をサポートするディストリビューターで少なくとも 1 回実行する必要があります。

キュー リーダー エージェント ジョブは、sp_dropdistributiondbの実行時に削除されます。

アクセス許可

sysadmin 固定サーバー ロールのメンバーのみが実行sp_addqreader_agentできます。

関連するコンテンツ