sp_MSchange_distribution_agent_properties (Transact-SQL)

變更執行於 Microsoft SQL Server 2005 或更新版本散發者端之散發代理程式作業的屬性。當發行者執行於 SQL Server 2000 的執行個體時,系統會利用這個預存程序來變更屬性。這個預存程序執行於散發資料庫的散發者端。

主題連結圖示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'
    這是發行集的名稱。publicationsysname,沒有預設值。

  • [**@subscriber=** ] 'subscriber'
    這是訂閱者的名稱。subscriber 是 sysname,沒有預設值。

  • [**@subscriber_db=** ] 'subscriber_db'
    這是訂閱資料庫的名稱。subscriber_db 是 sysname,沒有預設值。

  • [@property = ] 'property'
    這是要變更的發行集屬性。property 是 sysname,沒有預設值。

  • [@value = ] 'value'
    這是新的屬性值。value 是 nvarchar(524),預設值是 NULL。

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

    屬性

    描述

    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 或更新版本的執行個體時,您應該利用 sp_changesubscription 來變更合併代理程式作業的屬性,而這個作業會同步處理在散發者端執行的發送訂閱。

權限

只有散發者端之系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行 sp_MSchange_distribution_agent_properties