sp_addqreader_agent (Transact-SQL)

適用於:SQL ServerAzure SQL 受控執行個體

為指定的散發者新增佇列讀取器代理程式。 這個預存程式會在散發資料庫的散發者端或發行集資料庫的發行者端執行。

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為 bit,預設值為 0

1 表示程式正從發行集資料庫的發行者執行。

傳回碼值

0 (成功)或 1 (失敗)。

備註

sp_addqreader_agent 用於事務複製。

sp_addqreader_agent必須在支援佇列更新的散發者上至少執行一次,sp_adddistributiondb之後,但在sp_addpublication之前

當您執行 sp_dropdistributiondb時,會移除佇列讀取器代理程序作業。

權限

只有系統管理員固定伺服器角色的成員才能執行 sp_addqreader_agent