複寫佇列讀取器代理程式
適用於：
SQL Server
「複寫佇列讀取器代理程式」是一個可執行檔，會讀取儲存在 Microsoft SQL Server 佇列或 Microsoft Message 佇列中的訊息，然後將這些訊息套用至發行者。 佇列讀取器代理程式可搭配允許佇列更新的快照式和交易式發行集使用。
注意
您可以使用任何順序來指定參數。 沒有指定選擇性參數時，系統就會使用以預設代理程式設定檔為基礎的預先定義值。
語法
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
指定代理程式是否會嘗試連續處理佇列的交易。 如果您指定了這個參數，代理程式就會繼續執行，即使所有訂閱者都沒有任何佇列交易暫止也一樣。
-DefinitionFile def_path_and_file_name
這是代理程式定義檔的路徑。 代理程式定義檔包含代理程式的命令列引數。 此檔案的內容會剖析為可執行檔。 請使用雙引號 (") 來指定包含任意字元的引數值。
-Distributor server_name[\instance_name]
這是散發者的名稱。 請針對該伺服器上的 SQL Server 預設執行個體指定 server_name。 請針對該伺服器上的 SQL Server 具名執行個體指定 server_name\instance_name。 如果沒有指定這個參數，此名稱就會預設為本機電腦上 SQL Server 預設執行個體的名稱。
-DistributionDB distribution_database
這是散發資料庫。
-DistributorLogin distributor_login
這是散發者登入名稱。
-DistributorPassword distributor_password
這是散發者密碼。
-DistributorSecurityMode [ 0| 1]
指定散發者的安全性模式。 值為 0 表示 SQL Server 驗證模式 (預設值)，而值為 1 則表示 Windows 驗證模式。
-EncryptionLevel [ 0 | 1 | 2 ]
這是建立連線時，佇列讀取器代理程式所使用的傳輸層安全性 (TLS) (先前稱為安全通訊端層 (SSL)) 加密層級。
| EncryptionLevel 值 | 描述 |
|---|---|
| 0 | 指定不使用 TLS。 |
| 1 | 指定要使用 TLS，但是代理程式不會驗證 TLS/SSL 伺服器憑證是否由受信任的簽發者簽署。 |
| 2 | 指定要使用 TLS，而且憑證會經過驗證。 |
注意
定義的 TLS/SSL 憑證必須包含 SQL Server 的完整網域名稱才會有效。 為了讓代理程式能在將 -EncryptionLevel 設定為 2 時成功連線，請在本機 SQL Server 上建立別名。 'Alias Name' 參數應為伺服器名稱，且應將 'Server' 參數設為 SQL Server 的完整名稱。
如需詳細資訊，請參閱檢視及修改複寫安全性設定。
-HistoryVerboseLevel [ 0| 1| 2| 3]
指定在佇列讀取器作業期間記錄的記錄量。 您可以透過選取 1，盡量減少記錄作業對效能造成的影響。
| HistoryVerboseLevel 值 | 描述 |
|---|---|
| 0 | 無記錄 (不建議使用)。 |
| 1 | 預設值。 一律更新相同狀態的上一個記錄訊息 (啟動、進度、成功等等)。 如果沒有任何具有相同狀態的上一筆記錄存在，便插入新的記錄。 |
| 2 | 插入新的記錄，包括閒置訊息或長時間執行作業訊息。 |
| 3 | 插入新的記錄，包括可用於疑難排解的其他詳細資料。 |
-LoginTimeOut login_time_out_seconds
這是登入逾時之前的秒數。預設為 15 秒。
-Output output_path_and_file_name
這是代理程式輸出檔的路徑。 如果未提供檔案名稱，輸出將傳送至主控台。 如果指定的檔案名稱存在，輸出就會附加至該檔案。
-OutputVerboseLevel [ 0| 1| 2]
指定輸出是否應該詳細。 如果詳細資訊層級為 0，系統就只會列印錯誤訊息。 如果詳細資訊層級為 1，系統就會列印所有進度報表訊息。 如果詳細資訊層級為 2 (預設值)，系統就會列印所有錯誤訊息和進度報表訊息 (可用於偵錯)。
-PollingInterval polling_interval
這僅與使用 SQL Server 架構佇列的更新訂閱有關。 指定針對暫止佇列交易輪詢 SQL Server 佇列的頻率 (以秒為單位)。 此值可介於 0 與 240 秒之間。 預設值是 5 秒。
-PublisherFailoverPartner server_name[\instance_name]
指定參與具有發行集資料庫之資料庫鏡像工作階段的 SQL Server 容錯移轉夥伴執行個體。 如需詳細資訊，請參閱資料庫鏡像和複寫 (SQL Server)。
-ProfileName agent_profile_name
這是將一組預設值提供給代理程式所用之代理程式設定檔的名稱。 如需資訊，請參閱複寫代理程式設定檔。
-QueryTimeOut query_time_out_seconds
這是查詢逾時之前的秒數。預設值是 1800 秒。
-ResolverState [ 1| 2| 3]
指定解決佇列更新衝突的方式。 值為 1 表示發行者在衝突中獲勝，而且目前的衝突佇列交易將在發行者和原始更新訂閱者上回復。後續佇列交易的處理將繼續進行。 值為 2 表示訂閱者在衝突中獲勝，而且佇列交易將覆寫發行者的值。 值為 3 表示任何衝突將導致訂閱者重新初始化。發行者在衝突中獲勝、後續佇列交易的處理將結束，而且訂閱將重新初始化。 交易式發行集的預設設定為 1 ，而快照式發行集的預設設定為 3 。
備註
若要啟動佇列讀取器代理程式，請從命令提示字元執行 qrdrsvc.exe 。 如需詳細資訊，請參閱＜ 複寫代理程式可執行檔＞。