疑難排解 Fabric 鏡像資料庫

本文描述了 Microsoft Fabric 鏡像資料庫的常見情境、解決方案與解決方法。 針對每個資料來源,也要檢視具體的故障排除、常見問題(FAQ)及限制事項。

Area Reference
故障排除 用於Azure Cosmos DBAzure Database for PostgreSQLAzure SQL DatabaseAzure SQL Managed InstanceSnowflakeSQL ServerFabric SQL database的鏡像
局限性 Mirroring for Azure Cosmos DBAzure Database for PostgreSQLAzure DatabricksAzure SQL DatabaseAzure SQL Managed InstanceSnowflakeGoogle BigQueryOracleSAPSQL ServerFabric SQL database
FAQ Mirroring for Azure Cosmos DBAzure Database for PostgreSQLAzure DatabricksAzure SQL DatabaseAzure SQL Managed InstanceGoogle BigQuerySQL ServerFabric SQL database

Fabric 容量的變更

Scenario Description
Fabric 容量已暫停 鏡像已停止,而且您無法列出或存取鏡像資料庫項目。 恢復或重新指派容量至您的工作區。
光纖容量已恢復 當容量從暫停狀態恢復時,鏡映資料庫狀態會顯示為 [已暫停]。 因此,在來源中所做的變更不會複寫至 OneLake。
若要繼續鏡像,請移至 Fabric 入口網站中的鏡像資料庫,選取 [繼續複寫]。 鏡像從暫停的位置繼續進行。
請注意,如果容量長時間保持暫停狀態,鏡像可能不會從其停止點繼續,而且會從頭開始重新植入資料。 這是因為長時間暫停鏡像可能會導致來源資料庫的交易記錄檔使用量增加,並延遲記錄截斷。 為了將對資料庫的影響降到最低,如果使用的記錄空間接近已滿,則在回復鏡映時,會起始資料庫的重新植入,以釋放保留的記錄空間。
Fabric 容量擴展 鏡像仍在繼續。 如果您縮減容量,請注意,鏡像資料的 OneLake 儲存體會根據容量大小釋放至限制,因此縮減容量可能會產生額外的儲存體費用。 如需詳細資訊,請參閱 鏡像成本
網狀架構容量節流 等到過載狀態結束或更新您的容量。 一旦容量恢復,鏡射將繼續進行。 如需進一步了解 ,請參閱您可以採取的動作,以從超載狀況中復原
Fabric 試用容量已過期 鏡映已停止。 若要保留鏡像資料庫,請購買 Fabric 容量。 深入瞭解 Fabric 試用容量到期

資料似乎沒有複寫

如果您觀察到鏡映資料的外觀有延遲,請檢查下列項目:

  • 鏡像狀態: 在鏡像資料庫的 [網狀架構入口網站監視] 頁面 中,檢查鏡像資料庫和特定資料表的狀態,以及指出 Fabric 上次從來源重新整理鏡像資料表的「上次完成」資料行。 空表示資料表尚未鏡像。

    如果您啟用工作區監視,您可以從ReplicatorBatchLatency檔查詢值,以檢查鏡像執行延遲。

    針對 Azure SQL 資料庫Azure SQL 受控執行個體適用於 PostgreSQL 的 Azure 資料庫等來源類型,請遵循特定指示來檢查來源資料庫設定和狀態。

  • OneLake 中的資料: 鏡像會持續將您的資料複寫到 Delta Lake 資料表格式的 OneLake。 若要驗證資料是否正確登陸 OneLake,您可以建立從鏡像資料表到湖屋的捷徑,然後使用 Spark 查詢建置筆記本來查詢資料。 深入瞭解 使用筆記本探索

  • SQL 分析端點中的資料: 您可以透過鏡像資料庫的 SQL 分析端點或具有鏡像資料捷徑的 Lakehouse 來查詢鏡像資料。 當您看到延遲時,請先驗證 OneLake 中的鏡像狀態和數據,如上所述。 如果資料顯示在 OneLake 中,但未顯示在 SQL 分析端點中,則可能是因為 SQL 分析端點中 中繼資料同步處理 延遲所造成。

    您可以手動強制重新整理自動中繼資料掃描。 在 SQL 分析端點的頁面上,選取 [重新整理 ] 按鈕,如下圖所示。 等待一段時間,然後再次查詢資料進行檢查。

    Fabric 入口網站的螢幕擷取畫面,說明如何強制重新整理 SQL 分析端點中繼資料掃描。

停止複寫

當您選取 [停止複寫] 時,OneLake 檔案會保持原樣,但累加複寫會停止。 您可以隨時選取 [ 開始複寫] 來重新啟動複寫。 您可能想要在重設複寫狀態時、來源資料庫變更之後或作為疑難排解工具時執行停止/啟動複寫。

複寫來源結構描述階層

當您鏡像來自各種類型的來源資料庫的資料時,您的來源結構描述階層會保留在鏡像資料庫中。 它可確保您的資料在不同服務之間保持一致地組織,可讓您在 SQL 分析端點、Spark 筆記本、語意模型和其他資料參考中使用相同的邏輯來取用資料。

對於在啟用此功能之前建立的鏡像資料庫,您會看到來源結構描述在鏡像資料庫中平面化,而結構描述名稱會編碼到資料表名稱中。 如果您想要使用架構重新組織數據表,請重新建立鏡像資料庫。

如果您使用 API 來建立/更新鏡映資料庫,請設定屬性 defaultSchema的值,這表示是否要從來源資料庫抄寫結構描述階層。 請參閱 Microsoft Fabric 鏡像公用 REST API 中的定義範例。

Delta 資料行對應支援

鏡映支援將名稱中包含空格或特殊字元的資料行 (例如 ,;{}()\n\t=) 從來源資料庫複寫到鏡映資料庫。 在幕後,鏡像會將資料寫入 OneLake,並啟用 Delta 資料行對應。

對於在啟用此功能之前已在複寫中的資料表,若要在名稱中包含具有特殊字元的資料行,您必須移除並重新新增這些資料表,以更新鏡映資料庫設定,或停止並重新啟動鏡映資料庫。

取得鏡像資料庫的擁有權

目前,鏡像資料庫不支援擁有權變更。 如果鏡像資料庫因為專案擁有者已離開組織或不再有效而停止運作,您必須重新建立鏡像資料庫。

支援的區域

資料庫鏡像和開放式鏡像可在所有 Microsoft Fabric 區域中使用。 如需詳細資訊,請參閱 Fabric 區域可用性

Troubleshoot

本節包含一般鏡像疑難排解步驟。

我無法連線到來源資料庫

  1. 檢查您的連線詳細資料是否正確、伺服器名稱、資料庫名稱、使用者名稱和密碼。
  2. 檢查伺服器不在防火牆或私人虛擬網路後方。 開啟適當的防火牆連接埠。
    • 某些鏡像來源支援虛擬網路資料閘道或內部部署資料閘道,請參閱來源的檔以取得此功能的支援。

不會複製任何檢視

目前不支援檢視。 僅支援複寫一般資料表。

沒有複寫資料表

  1. 檢查監控狀態以檢查表格的狀態。 如需詳細資訊,請參閱 監視 Fabric 鏡映資料庫複寫
  2. 選取 [設定複寫 ] 按鈕。 檢查表格是否存在於表格清單中,或每個表格詳細資料上是否有任何警示。

目的地資料表中缺少資料行

  1. 選取 [設定複寫 ] 按鈕。
  2. 如果未抄寫任何資料行,請選取表格詳細資料旁邊的警示圖示。

我專欄中的一些數據似乎被截斷了

SQL 分析端點支援 varchar(max) 的最大容量為 16 MB。

  • 16 MB 的限制適用於 2025 年 11 月 18 日後在鏡像資料庫中建立的資料表,但每種鏡像項目類型可能有不同的且較低的限制。 例如,鏡像 SQL Server 支援最多 1 MB,Cosmos DB 則支援最高 2 MB。 請參閱下表。
  • 2025 年 11 月 18 日之前建立的現有資料表僅支援 varchar(8000), 需重新建立以採用新資料型態並支援超過 8 KB 的資料。
鏡像平台項目 varchar(max) 限制
經鏡像的SQL Server、Azure SQL資料庫、Azure SQL受管執行個體 1 MB
Fabric 中的 SQL 資料庫 1 MB
鏡像 Azure Cosmos 資料庫 2 MB
Fabric 中的 Cosmos DB 2 MB

鏡像的資料表/架構在丟棄到來源資料庫時不會被刪除

表層:

  • 當你選擇鏡像一串選擇性資料表且丟棄來源資料表時,鏡像資料表會保留,監控時會顯示錯誤訊息「來源資料表不存在」。 如果你不想再複製這個資料表,更新鏡像資料庫設定並移除它,鏡像資料表就會被刪除。
  • 當你選擇鏡像所有資料且來源資料表被丟棄時,鏡像資料表也會被刪除。

結構層級:當結構被丟棄到來源資料庫時,你在 SQL Analytics 端點中仍會看到該結構為空的結構。

我無法變更來源資料庫

不支援變更來源資料庫。 建立新的鏡像資料庫。

限制錯誤訊息

這些常見錯誤訊息有說明和緩解措施:

錯誤訊息 風險降低
“桌子數量可能超過限制,可能會缺少一些桌子。” 最多有 500 張桌子。 在來源資料庫中,捨棄或篩選資料表。 如果新資料表是第 500 個資料表,則不需要緩解措施。
“複製正在受到限制,預計將在 YYYY-MM-DDTHH:MM:ss 繼續。” 每個鏡像資料庫每天最多擷取 1 TB 的變更資料。 等候節流結束。