複寫佇列讀取器代理程式

「複寫佇列讀取器代理程式」是一個可執行檔,它會讀取儲存在 Microsoft SQL Server 佇列或 Microsoft Message Queue 中的訊息,然後將這些訊息套用至發行者。 佇列讀取器代理程式可搭配允許佇列更新的快照式和交易式發行集使用。

[!附註]

您可以使用任何順序來指定參數。 沒有指定選擇性參數時,系統就會使用以預設代理程式設定檔為基礎的預先定義值。

語法

qrdrsvc [-?]
[-Continuous]
[-DefinitionFile definition_file]
[-Distributor server_name[\instance_name]]
[-DistributionDB distribution_database]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-HistoryVerboseLevel [0|1|2|3]]
[-LoginTimeOut login_time_out_seconds]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2]]
[-PollingInterval polling_interval]
[-PublisherFailoverPartner server_name[\instance_name] ]
[-ProfileName agent_profile_name]
[-QueryTimeOut query_time_out_seconds]
[-ResolverState [1|2|3]]

引數

  • -?
    顯示使用方式資訊。

  • -Continuous
    指定代理程式是否會嘗試連續處理佇列的交易。 如果您指定了這個參數,代理程式就會繼續執行,即使所有訂閱者都沒有任何佇列交易暫止也一樣。

  • -DefinitionFiledef_path_and_file_name
    這是代理程式定義檔的路徑。 代理程式定義檔包含代理程式的命令列引數。 此檔案的內容會剖析為可執行檔。 請使用雙引號 (") 來指定包含任意字元的引數值。

  • -Distributorserver_name[**\**instance_name]
    這是散發者的名稱。 請針對該伺服器上的 SQL Server 預設執行個體指定 server_name。 請針對該伺服器上的 SQL Server 具名執行個體指定 server_name\instance_name。 如果沒有指定這個參數,此名稱就會預設為本機電腦上 SQL Server 預設執行個體的名稱。

  • -DistributionDBdistribution_database
    這是散發資料庫。

  • -DistributorLogindistributor_login
    這是散發者登入名稱。

  • -DistributorPassworddistributor_password
    這是散發者密碼。

  • -DistributorSecurityMode [ 0| 1]
    指定散發者的安全性模式。 值為 0 表示 SQL Server 驗證模式 (預設值),而值為 1 則表示 Windows 驗證模式。

  • -EncryptionLevel [ 0 | 1 | 2 ]
    這是建立連接時,佇列讀取器代理程式所使用的安全通訊端層 (SSL) 加密層級。

    EncryptionLevel 值

    說明

    0

    指定不使用 SSL。

    1

    指定要使用 SSL,但是代理程式不會驗證 SSL 伺服器憑證是否由受信任的簽發者簽署。

    2

    指定要使用 SSL,而且憑證會經過驗證。

    如需詳細資訊,請參閱<安全性概觀 (複寫)>。

  • -HistoryVerboseLevel [ 0| 1| 2| 3]
    指定在佇列讀取器作業期間記錄的記錄量。 您可以透過選取 1,盡量減少記錄作業對效能造成的影響。

    HistoryVerboseLevel 值

    說明

    0

    無記錄 (不建議使用)。

    1

    預設。 一律更新相同狀態的上一個記錄訊息 (啟動、進度、成功等等)。 如果沒有任何具有相同狀態的上一筆記錄存在,便插入新的記錄。

    2

    插入新的記錄,包括閒置訊息或長時間執行作業訊息。

    3

    插入新的記錄,包括可用於疑難排解的其他詳細資料。

  • -LoginTimeOutlogin_time_out_seconds
    這是登入逾時之前的秒數。 預設值是 15 秒。

  • -Outputoutput_path_and_file_name
    這是代理程式輸出檔的路徑。 如果未提供檔案名稱,輸出將傳送至主控台。 如果指定的檔案名稱存在,輸出就會附加至該檔案。

  • -OutputVerboseLevel [ 0| 1| 2]
    指定輸出是否應該詳細。 如果詳細資訊層級為 0,系統就只會列印錯誤訊息。 如果詳細資訊層級為 1,系統就會列印所有進度報表訊息。 如果詳細資訊層級為 2 (預設值),系統就會列印所有錯誤訊息和進度報表訊息 (可用於偵錯)。

  • -PollingIntervalpolling_interval
    這僅與使用 SQL Server 架構佇列的更新訂閱有關。 指定針對暫止佇列交易輪詢 SQL Server 佇列的頻率 (以秒為單位)。 此值可介於 0 與 240 秒之間。 預設值是 5 秒。

  • -PublisherFailoverPartner server_name[**\**instance_name]
    指定參與具有發行集資料庫之資料庫鏡像工作階段的 SQL Server 容錯移轉夥伴執行個體。 如需詳細資訊,請參閱<資料庫鏡像和複寫 (SQL Server)>。

  • -ProfileNameagent_profile_name
    這是將一組預設值提供給代理程式所用之代理程式設定檔的名稱。 如需相關資訊,請參閱<複寫代理程式設定檔>。

  • -QueryTimeOutquery_time_out_seconds
    這是查詢逾時之前的秒數。 預設值是 1800 秒。

  • -ResolverState [ 1| 2| 3]
    指定解決佇列更新衝突的方式。 值為 1 表示發行者在衝突中獲勝,而且目前的衝突佇列交易將在發行者和原始更新訂閱者上回復。後續佇列交易的處理將繼續進行。 值為 2 表示訂閱者在衝突中獲勝,而且佇列交易將覆寫發行者的值。 值為 3 表示任何衝突將導致訂閱者重新初始化。發行者在衝突中獲勝、後續佇列交易的處理將結束,而且訂閱將重新初始化。 交易式發行集的預設設定為 1,而快照式發行集的預設設定為 3

備註

若要啟動佇列讀取器代理程式,請從命令提示字元執行 qrdrsvc.exe。 如需詳細資訊,請參閱<複寫代理程式可執行檔>。

請參閱

概念

複寫代理程式管理