疑難排解：尋找 SQL Server 異動複寫的錯誤

發行項
05/04/2023

適用於：SQL Server Azure SQL 受控執行個體

若對異動複寫的運作方式沒有基本的了解，針對複寫錯誤進行疑難排解可能會令人感到沮喪。建立發行集的第一個步驟是讓快照集代理程式建立快照集，並將它儲存到快照集資料夾。接下來，散發代理程式會將快照集套用到訂閱者。

此處理序會建立發行集，並將它置於「同步處理」狀態。同步處理將分成三個階段進行：

交易將在複寫的物件上發生，且在交易記錄中會標示為「供複寫」。
記錄讀取器代理程式會掃描交易記錄，並尋找標示為「用於複寫」的交易。這些交易接著會儲存至散發資料庫。
散發代理程式會使用讀取器執行緒來掃描散發資料庫。接著，此代理程式會使用寫入器執行緒連線至訂閱者，將這些變更套用到該訂閱者。

此處理序的任何步驟都可能會發生錯誤。尋找這些錯誤可能是同步處理問題疑難排解中最具挑戰性的層面。幸好使用複寫監視器可簡化此處理序。

注意

本疑難排解指南旨在教導疑難排解方法。它的設計目的不是解決您的特定錯誤，而是提供尋找複寫錯誤的一般指導方針。提供了一些特定範例，但它們的解決方法可能會因環境而有所不同。
本指南提供作為範例的錯誤是根據設定異動複寫教學課程。

疑難排解方法

要思考的問題

在同步處理過程中的哪個位置複寫失敗？
哪個代理程式發生錯誤？
上次複寫成功執行是什麼時候？自那時起有任何變更嗎？

需採取的步驟

使用複寫監視器來找出複寫發生錯誤的時間點 (哪個代理程式？)：
- 如果在發行者到散發者區段中發生錯誤，則問題出自記錄讀取器代理程式。
- 如果在散發者到訂閱者區段中發生錯誤，則問題出自散發代理程式。
查看該代理程式在 [作業活動監視器] 中的作業記錄，以找出錯誤的詳細資料。如果作業記錄未顯示足夠的詳細資料，您可以在該特定代理程式上啟用詳細資訊記錄。
嘗試判斷適用於該錯誤的解決方案。

尋找快照集代理程式的錯誤

快照集代理程式會產生快照集，並將它寫入至指定的快照集資料夾。

檢視快照集代理程式的狀態：

a. 在 [物件總管] 中，展開 [複寫] 下的 [本機發行集] 節點。

b. 以滑鼠右鍵按一下您的發行集 AdvWorksProductTrans>[檢視快照集代理程式的狀態]。
如果快照集代理程式狀態回報錯誤，您可在快照集代理程式的作業記錄中找到更多詳細資料：

a. 展開 [物件總管] 中的 [SQL Server Agent]，然後開啟 [作業活動監視器]。

b. 依據 [分類] 排序，並依分類 REPL-Snapshot 找出快照集代理程式。

c. 以滑鼠右鍵按一下快照集代理程式，然後選取 [檢視記錄]。
在快照集代理程式記錄中，選取相關的記錄項目。這通常是報告該錯誤之項目「前」的一兩行。 (紅色 X 表示錯誤。) 檢閱記錄下方方塊中的訊息內文：
```
The replication agent had encountered an exception.
Exception Message: Access to path '\\node1\repldata.....' is denied.
```

如果您未正確設定快照集資料夾的 Windows 權限，您會看到快照集代理程式發生「拒絕存取」錯誤。您必須驗證快照集儲存所在之資料夾的權限，並確定用來執行快照集代理程式的帳戶具有存取該共用的權限。

尋找記錄讀取器代理程式的錯誤

記錄讀取器代理程式會連線到您的發行者資料庫，並掃描交易記錄中是否有標示為「用於複寫」的任何交易。然後將這些交易新增至散發資料庫。

在 SQL Server Management Studio 中連線到發行者。展開伺服器節點，再以滑鼠右鍵按一下 [複寫] 資料夾，然後選取 [啟動複寫監視器]：

複寫監視器隨即開啟：
紅色 X 表示發行集未執行同步處理。展開左側的 [我的發行者]，再展開相關的發行者伺服器。
在左側選取 AdvWorksProductTrans 發行集，然後在其中一個索引標籤中尋找紅色 X，以找出問題所在。在本例中，紅色 X 出現在 [代理程式] 索引標籤上，因此其中一個代理程式發生錯誤：
選取 [代理程式] 索引標籤以找出發生錯誤的代理程式：

此檢視會向您顯示兩個代理程式：快照集代理程式和記錄讀取器代理程式。發生錯誤的代理程式會有一個紅色 X。在此情況下，它是記錄讀取器代理程式。

在報告錯誤的行上按兩下，以開啟記錄讀取器代理程式的代理程式記錄。此記錄會提供有關錯誤的詳細資訊：

記錄讀取器代理程序錯誤詳細數據的螢幕快照。

Status: 0, code: 20011, text: 'The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.'.
The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.
Status: 0, code: 15517, text: 'Cannot execute as the database principal because the principal "dbo" does not exist, this type of principal cannot be impersonated, or you do not have permission.'.
Status: 0, code: 22037, text: 'The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.'.

若未正確設定發行者資料庫的擁有者，通常會發生這個錯誤。還原資料庫時也可能會發生此錯誤。若要驗證這一點，請：

a. 在 [物件總管] 中展開 [資料庫]。

b. 以滑鼠右鍵按一下 [AdventureWorks2022]>[屬性]。

c. 確認擁有者位在 [檔案] 頁面之下。如果此方塊為空白，這可能就是問題的原因。

如果 [檔案] 頁面上的擁有者為空白，請在 AdventureWorks2022 資料庫的內容中開啟 [新增查詢] 視窗。執行下列 T-SQL 程式碼：

-- set the owner of the database to 'sa' or a specific user account, without the brackets. 
EXECUTE sp_changedbowner '<useraccount>'
-- example for sa: exec sp_changedbowner 'sa'
-- example for user account: exec sp_changedbowner 'sqlrepro\administrator'

您可能需要重新啟動記錄讀取器代理程式：

a. 展開 [物件總管] 的 [SQL Server Agent] 節點，然後開啟 [作業活動監視器]。

b. 依據 [分類] 排序，並依 REPL-LogReader 分類找出記錄讀取器代理程式。

c. 以滑鼠右鍵按一下 [記錄讀取器代理程式] 作業，然後選取 [從下列步驟啟動作業]。
再次開啟複寫監視器，以驗證您的發行集現在正執行同步處理。如果它尚未開啟，只要以滑鼠右鍵按一下 [物件總管] 中的 [複寫] 即可找到它。
依序選取 AdvWorksProductTrans 發行集和 [代理程式] 索引標籤，並按兩下選取記錄讀取器代理程式來開啟代理程式記錄。您現在應會看到記錄讀取器代理程式在執行中，且正在複寫命令或其有「無複寫交易」:

尋找散發代理程式的錯誤

散發代理程式會在散發資料庫中尋找資料，然後將它套用到訂閱者。

在 SQL Server Management Studio 中連線到發行者。展開伺服器節點，再以滑鼠右鍵按一下 [複寫] 資料夾，然後選取 [啟動複寫監視器]。
在 [複寫監視器] 中，選取 [AdvWorksProductTrans] 發行集，然後選取 [所有訂閱] 索引標籤。以滑鼠右鍵按一下訂閱，然後選取 [檢視詳細資料]：

[散發者到訂閱者記錄] 對話方塊隨即開啟，並會釐清代理程式發生哪個錯誤：

散發代理程式錯誤詳細數據的螢幕快照。

Error messages:
Agent 'NODE1\SQL2016-AdventureWorks2022-AdvWorksProductTrans-NODE2\SQL2016-7' is retrying after an error. 89 retries attempted. See agent job history in the Jobs folder for more details.

此錯誤指出散發代理程式正在重試。若要尋找更多詳細資訊，請檢查散發代理程式作業記錄：

a. 展開 [物件總管] 中的 [SQL Server Agent] >[作業活動監視器]。

b. 依分類排序作業。

c. 依分類 REPL-Distribution 找出散發代理程式。以滑鼠右鍵按一下代理程式，然後選取 [檢視記錄]。

選取其中一個錯誤項目，檢視視窗底部的錯誤文字：

錯誤文字的螢幕快照，指出散發代理程式的密碼錯誤。

Message:
Unable to start execution of step 2 (reason: Error authenticating proxy NODE1\repl_distribution, system error: The user name or password is incorrect.)

這個錯誤指出散發代理程式所使用的密碼不正確。若要解決此問題，請：

a. 展開 [物件總管] 中的 [複寫] 節點。

b. 以滑鼠右鍵按一下訂閱 >[屬性]。

c. 選取代理程式處理帳戶旁的省略符號 (...) 並修改密碼。
以滑鼠右鍵按一下 [物件總管] 中的 [複寫]，再次檢查複寫監視器。 [所有訂閱] 下的紅色 X 指出散發代理程式仍有錯誤。

以滑鼠右鍵按一下 [複寫監視器]>[檢視詳細資料] 中的訂閱，開啟 [發佈到訂閱者] 記錄。現在錯誤變得不一樣了：
```
Connecting to Subscriber 'NODE2\SQL2016'        
Agent message code 20084. The process could not connect to Subscriber 'NODE2\SQL2016'.
Number:  18456
Message: Login failed for user 'NODE2\repl_distribution'.
```
此錯誤指出散發代理程式無法連線至訂閱者，因為使用者 NODE2\repl_distribution 登入失敗。若要進一步調查，請連線至訂閱者並開啟 [物件總管] 中 [管理] 節點下「目前的」SQL Server 錯誤記錄：

如果您看到這個錯誤，則表示訂閱者缺少登入。若要解決這個錯誤，請參閱複寫的權限。
登入錯誤解決之後，請再次檢查複寫監視器。如果所有問題都獲得解決，您應該會在發行集名稱旁看到一個綠色箭號，而且 [所有訂閱] 下的狀態為 [執行中]。

再以滑鼠右鍵按一下訂閱，以啟動 [散發者到訂閱者] 記錄，確認是否成功。如果這是散發代理程式第一次執行，您會看到快照集已大量複製到訂閱者：

在任何代理程式上啟用詳細資訊記錄

您可以使用詳細資訊記錄，來查看有關複寫拓撲中任何代理程式所發生錯誤的更多詳細資訊。每個代理程式的步驟都相同。只要確定您在 [作業活動監視器] 中選取正確的代理程式。

注意

代理程式可以位於發行者或訂閱者上，視它是提取或發送訂閱而定。如果您在調查的伺服器上無法使用代理程式，請檢查另一部伺服器。

決定您要儲存詳細資訊記錄的位置，並確保此資料夾已存在。這個範例會使用 c:\temp。
展開 [物件總管] 的 [SQL Server Agent] 節點，然後開啟 [作業活動監視器]。
依據 [分類] 排序，並找出您感興趣的代理程式。這個範例會使用記錄讀取器代理程式。以滑鼠右鍵按一下您感興趣的代理程式 >[屬性]。
選取 [步驟] 頁面，然後反白顯示 [執行代理程式] 步驟。選取 [編輯]。
在 [命令] 方塊中，開始新的一行，輸入下列文字，然後選取 [確定]：
```
-Output C:\Temp\OUTPUTFILE.txt -Outputverboselevel 3
```
您可以根據自己的喜好修改位置和詳細資訊層級。
注意

新增詳細資訊輸出參數時，下列作業可能會導致代理程序失敗，或遺漏 outfile 檔案：
- 有一個格式問題，其中虛線變成連字號。
- 該位置不存在於磁碟上，或執行代理程式的帳戶缺少寫入指定位置的權限。
- 最後一個參數與 -Output 參數之間遺漏一個空格。
- 不同的代理程式支援不同層級的詳細資訊。如果您啟用詳細資訊記錄，但代理程式無法啟動，請嘗試將指定的詳細資訊層級減少 1。
以滑鼠右鍵按一下代理程式 > [從下列步驟停止作業]，重新啟動記錄讀取器代理程式。選取工具列中的 [重新整理] 圖示以重新整理。以滑鼠右鍵按一下代理程式 > [從下列步驟啟動作業]。
檢閱磁碟上的輸出。
若要停用詳細資訊記錄，請遵循相同的上一個步驟來移除您之前新增的一整行 -Output。