疑難排解 Fabric 鏡像資料庫

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

來源 局限性 Troubleshoot FAQ
Azure Cosmos DB 限制 疑難排解 常見問題集
適用於 MySQL 的 Azure 資料庫 限制 疑難排解 常見問題集
適用於 PostgreSQL 的 Azure 資料庫 限制 疑難排解 常見問題集
Azure Databricks 限制 常見問題集
Azure SQL Database 限制 疑難排解 常見問題集
Azure SQL 受控執行個體 限制 疑難排解 常見問題集
網狀架構 SQL 資料庫 限制 疑難排解 常見問題集
谷歌 BigQuery 限制 常見問題集
Oracle 限制
SAP 限制
Snowflake 限制 疑難排解
SQL Server 限制 疑難排解 常見問題集

Fabric 系統容量的變更

Scenario Description
Fabric 容量已被暫停 鏡像功能會停止,你無法列出或存取鏡像的資料庫項目。 恢復或重新指派容量至您的工作區。
光纖容量已恢復 當你從暫停狀態恢復容量時,鏡像資料庫狀態會顯示為 暫停。 因此,在來源中所做的變更不會複寫至 OneLake。
若要繼續鏡像,請移至 Fabric 入口網站中的鏡像資料庫,選取 [繼續複寫]。 鏡像從暫停的位置繼續。
若系統容量長時間暫停,鏡像可能無法從停止點繼續進行,而是從頭重新同步資料。 重播的發生是因為長時間暫停鏡像會導致來源資料庫的交易日誌使用量增加,並防止日誌截斷。 為了減少對來源資料庫的影響,若所使用的日誌空間接近滿,鏡像恢復時,重新初始化資料庫將釋放日誌空間。
Fabric 容量擴展 鏡像仍在繼續。 如果你縮小容量,請注意,對於鏡像資料的 OneLake 儲存空間,在一定的容量限制內是免費的,因此縮小容量可能會產生額外的儲存費用。 更多資訊請參見 鏡像成本
網狀架構容量節流 等到過載狀態結束或更新您的容量。 一旦容量恢復,鏡像仍會繼續進行。 更多資訊請參閱 「你可以採取的措施來從過載情況中恢復」。
Fabric 試用容量已過期 鏡像系統停止了。 若要保留鏡像資料庫,請購買 Fabric 容量。 更多資訊請參閱 Fabric 試用容量過期

資料似乎沒有複寫

如果你觀察到鏡像資料出現延遲,請檢查以下項目:

  • 鏡像狀態: 在鏡像資料庫的 Fabric 入口監控頁面 中,檢查鏡像資料庫及特定資料表的狀態。 檢查「最後完成」欄位,該欄位顯示 Fabric 上次從來源刷新鏡像資料表的時間。 空值表示該資料表尚未鏡像。

    如果你啟用工作區監控,可以透過查詢ReplicatorBatchLatency鏡像資料庫操作日誌中的值來檢查鏡像執行延遲。

    對於像 Azure SQL DatabaseAzure SQL Managed InstanceAzure Database for MySQLAzure Database for PostgreSQL 這類原始碼類型,請依照特定指示檢查來源資料庫的設定與狀態。

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

  • SQL 分析端點中的資料: 您可以透過鏡像資料庫的 SQL 分析端點或具有鏡像資料捷徑的 Lakehouse 來查詢鏡像資料。 當你看到延遲時,如前所述,在 OneLake 中驗證鏡像狀態和資料。 如果資料顯示在 OneLake 但 SQL 分析端點沒有,可能是因為 SQL 分析端點的 元資料同步 延遲所致。

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

    Fabric 入口網站上的螢幕擷取畫面,展示如何強制更新 SQL 分析端點的中繼資料掃描。

停止複寫

當您選取 [停止複寫] 時,OneLake 檔案會保持原樣,但累加複寫會停止。 您可以隨時選取 [ 開始複寫] 來重新啟動複寫。 你可能想在重設複製狀態、來源資料庫變更後,或作為故障排除工具,先停止並開始複製。

複製來源架構階層

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

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

如果你使用 API 來建立或更新鏡像資料庫,請設定 defaultSchema 屬性值,指示是否要複製來源資料庫的結構階層。 請參考 Microsoft Fabric mirroring public 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 DB 2 MB
Fabric 中的 Cosmos DB 2 MB

您在來源資料庫中刪除已鏡像的資料表或結構時,它不會被刪除。

表級別:

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

架構層級:當你把結構放進來源資料庫時,你在 SQL Analytics 端點中仍會看到該結構是空的結構。

我無法變更來源資料庫

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

限制錯誤訊息

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

錯誤訊息 原因 緩解
「桌子數量可能超過上限,可能有些桌子不見了。」 最多有1000張桌子。 在來源資料庫中,捨棄或篩選資料表。 如果新表格是第 1,000 張表格,則不需要緩解措施。
“複製目前被限速,預計會在 YYYY-MM-DDTHH:MM:ss 繼續。” 每個鏡像資料庫每天最多擷取 1 TB 的變更資料。 等候節流結束。