sp_MSchange_distribution_agent_properties （Transact-SQL）

  • 發行項

適用於：SQL Server

變更在 Microsoft SQL Server 2005 （9.x） 或更新版本散發者端執行的 散發代理程式 作業屬性。 當發行者在 SQL Server 2000 （8.x） 實例上執行時，這個預存程式會用來變更屬性。 這個預存程式會在散發資料庫的散發者端執行。

Transact-SQL 語法慣例

語法

  
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' 這是要變更的發行集屬性。 屬性 為 sysname，沒有預設值。

[ @value = ] 'value' 這是新的屬性值。 值為 nvarchar（524），預設值為 NULL。

下表描述可變更之 散發代理程式 作業的屬性，以及這些屬性的值限制。

屬性 數值 Description
distrib_job_login 登入代理程序執行所在的 Microsoft Windows 帳戶。
distrib_job_password 代理程式作業執行所在的 Windows 帳戶密碼。
subscriber_catalog 與 OLE DB 提供者建立連接時要使用的目錄。 此屬性僅適用於非 SQL Server 訂閱者。
subscriber_datasource OLE DB 提供者所了解的數據來源名稱。 此屬性僅適用於非 SQL Server 訂閱者。
subscriber_location OLE DB 提供者所了解的資料庫位置。 此屬性僅適用於非 SQL Server 訂閱者。
subscriber_login 連接到訂閱者以同步處理訂閱時使用的登入。
subscriber_password 訂閱者密碼。

請勿使用空白密碼。 請使用增強式密碼。
subscriber_provider 註冊非 SQL Server 數據來源之 OLE DB 提供者的唯一程式設計標識碼 （PROGID）。 此屬性僅適用於非 SQL Server 訂閱者。
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 發行者或點對點訂閱。

注意

變更代理程式的登入或密碼之後，您必須先停止並重新啟動代理程式，變更才會生效。

傳回碼值

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）