Microsoft Fabric 中的鏡像提供了順暢的無 ETL 體驗，可將現有的 Azure Cosmos DB 資料與 Fabric 中的其餘資料整合。 使用本文中的秘訣，協助您針對在 Fabric 中為 Azure Cosmos DB 建立鏡像資料庫時可能會遇到的問題進行疑難排解。
重要
Azure Cosmos DB 的鏡像功能目前為預覽版。 預覽期間不支援生產工作負載。 目前僅支援 Azure Cosmos DB for NoSQL 帳戶。
以下是將 Azure Cosmos DB 資料庫鏡像至 Microsoft Fabric 未如預期般運作時的常見問題和需要遵循的相關疑難排解步驟清單。
載入資料庫時鏡像失敗並發生「SQLAPIendpoint」錯誤。 如何解決此錯誤？
此錯誤通常表示您所選連線的 Azure Cosmos DB 帳戶金鑰已不再有效。 使用有效的帳戶金鑰更新連線認證之後，再次設定鏡像。
Fabric 無法設定鏡像並出現錯誤，指出我的 Azure Cosmos DB 帳戶沒有連續備份。 我該如何修正此錯誤？
啟用 Azure Cosmos DB 帳戶的連續備份。 如需詳細資訊，請參閱建立具有連續備份的 Azure Cosmos DB 帳戶或將現有的 Azure Cosmos DB 帳戶移轉至連續備份。
啟用連續備份功能之後，返回 Fabric 鏡像設定，並繼續執行其餘步驟。
如何知道我的 Azure Cosmos DB 帳戶是否已啟用續備份？
使用 Azure 入口網站，您可以藉由在 Azure Cosmos DB 帳戶的資源功能表中找到 [時間點還原] 選項，來檢查是否已啟用連續備份功能。 如果無法使用此選項，則表示帳戶未啟用連續備份，或帳戶正在移轉至連續備份。
在我的 Azure Cosmos DB 帳戶中啟用連續備份會導致各種錯誤。 我仍然可以設定 Fabric 鏡像嗎？
不，必須針對預期作為鏡像來源的 Azure Cosmos DB 帳戶啟用連續備份。
如果為 Azure Cosmos DB 帳戶啟用連續備份時出現錯誤訊息，帳戶可能會有封鎖此功能的限制。 例如，如果您先前刪除了帳戶的分析存放區，帳戶就無法支援連續備份。 在此案例中，剩餘的唯一選項是使用新的 Azure Cosmos DB 帳戶進行鏡像。
為什麼當我選取 [監視複寫] 時，複寫無法運作，並且我會收到「內部伺服器錯誤」？
如果 Azure Cosmos DB 正在節流來自 Fabric 的要求，複寫可能會正常運作，而且您會觀察到暫時性錯誤。 此外，Azure Cosmos DB 的鏡像也可能會造成此問題。 如需詳細資訊，請參閱 Azure Cosmos DB 鏡像限制。
重新整理 Fabric 入口網站，並判斷問題是否已自動解決。 此外，您也可以停止並啟動複寫。 如果這些選項都不起作用，請支援票證支援票證。
如何確定 Fabric 正在從 Azure Cosmos DB 複寫資料？
首先，請遵循 Fabric 鏡像資料庫的一般疑難排解步驟。 如需詳細資訊，請參閱疑難排解。
在大部分情況下，[監視複寫] 選項可以提供進一步的詳細資料，指出資料是否成功複寫至 Fabric。 常見的疑難排解步驟是，檢查 [上次重新整理的時間] 是否是最近。 如果該時間不是最近時間，請停止然後重新啟動複寫作為下一個步驟。 請注意，只有當來源資料庫自複寫記下的時間以來有所變更時，才會更新「上次重新整理的時間」。 如果來源資料庫沒有更新、刪除或插入，將不會更新「上次重新整理的時間」。
「監視複寫」窗格包含的資料表在很長時間后仍沒有複寫任何資料列。 複寫是否停滯？
複寫可能會停滯。 停止並重新啟動複寫作為第一個步驟。 如果此步驟不起作用，請開立支援票證。
為什麼我在 SQL 分析端點中找不到任何資料表？
首先，重新整理 [結構描述] 和 [dbo] 節點，以判斷資料表是否已就緒。 資料表會在準備好後自動載入。 如果在很長時間後仍沒有任何資料表就緒，請使用 [監視複寫] 窗格來判斷是否發生了任何複寫錯誤。
為什麼我的目標倉儲資料表在複寫之後只包含『_rid』資料行？
首先，重新整理 [結構描述] 和 [dbo] 節點，以判斷資料表是否已就緒。 資料表會在準備好後自動載入。 如果在很長時間後仍沒有更多資料行就緒，請使用 [監視複寫] 窗格來判斷是否發生了任何複寫錯誤。
我已將新項目新增至我的 Azure Cosmos DB 資料庫中的容器。 這些項目沒有包含在我的 SQL 分析端點查詢結果中。 如何知道複寫是否正常運作？
[監視複寫] 選項可以提供進一步的詳細資料，指出資料是否成功複寫至 Fabric。 常見的疑難排解步驟是，檢查 [上次重新整理的時間] 是否是最近。 如果該時間不是最近時間，請停止然後重新啟動複寫作為下一個步驟。 如果該時間是最近時間，請再次嘗試您的查詢。 有時候，將資料插入 Azure Cosmos DB，以及在 Fabric 中複寫和提供資料之間可能會有延遲。
如果資料仍然無法使用，請使用 Lakehouse 建立捷徑，並從筆記本執行 Spark 查詢。 Spark 一律會顯示最新的資料。 如果資料可在 Spark 中使用，但無法用於 SQL 分析，請開立支援票證。
如果 Spark 中也無法使用資料，則複寫延遲可能發生了非預期的問題。 等候一段時間，然後重試複寫。 如果問題持續發生，請開立支援票證。
為什麼在針對我的 SQL 分析端點執行 T-SQL 查詢時， 會收到錯誤訊息「JSON 文字的格式不正確。在位置上找到非預期字元 '"'」？
資料倉儲無法處理大小超過 8 KB 的 JSON 字串資料行。 在 SQL 分析端點或倉儲資料表中表示為 JSON 字串的巢狀資料，通常會導致資料行的大小增加至 8 KB 以上。 如果您收到此錯誤訊息，則監視巢狀層級和資料量。 如需詳細資訊，請參閱資料倉儲限制。
為什麼我會在 [監視複寫] 窗格中收到「資料行名稱無效」錯誤？
鏡像不支援包含以下項目的容器：屬性名稱中包含空格符或通配符。 這項限制會導致特定容器的鏡像失敗。 相同資料庫內的其他容器仍可成功鏡像。 如需詳細資訊，請參閱複寫限制。