SQL 分析端點中繼資料同步

本文說明什麼是 SQL 分析端點、它如何與你的 Lakehouse 保持同步，以及你需要管理同步所需的控制措施。SQL 分析端點會自動偵測變更，並透過背景程序更新其 SQL 中繼資料。 你也可以透過Fabric入口網站、REST API 或 T-SQL 儲存程序，手動刷新 SQL 分析端點的元資料。

背景的元資料同步程序會從 OneLake 資料夾讀取 Delta 日誌 /Tables ，並保持 SQL 架構的最新狀態。

Microsoft Fabric 會自動讓 SQL 分析端點與底層湖屋同步。 沒有基礎設施需要建立，而且大多數情況下，也不需要用戶操作。 平台負責：

• 資料表發現 ——偵測湖屋中新建立或遺失的 Delta 資料表，並在端點建立或移除對應的 SQL 資料表。
• 資料新鮮度 - 偵測現有資料表中資料的變更（插入、更新、刪除），並確保查詢回傳最新結果。
• 結構變更偵測 ——偵測現有 Delta 資料表中的欄位新增、移除或型別變更，並刷新對應的 SQL 資料表定義。

關於同步的運作方式及影響同步延遲的因素，請參見 SQL 分析端點效能考量。

結構變更偵測與元資料同步

Fabric 中的每個 Lakehouse、倉庫、資料庫和鏡像資料庫都會自動配置自己的 SQL 分析端點，因此你可以用 T-SQL 和 TDS 協定查詢 Delta 資料表，無需移動或複製資料。

• 每個 Lakehouse、倉庫、資料庫和鏡像資料庫，都恰好有一個 SQL 分析端點。
• 底層項目中的每個 Delta 資料表會自動以 SQL 表格的形式出現在端點中。
• 此端點對自動產生的資料表為唯讀。 你可以用自己的 SQL 架構、檢視、儲存程序和函式來擴充模型。
• 該端點由與 Fabric Data Warehouse 相同的運算引擎驅動，因此能針對開啟的 Delta 檔案提供高效能、低延遲的 SQL 查詢。

新元資料同步（預覽）

Important

這項功能目前處於預覽階段。

2026 年 5 月，SQL 分析端點的新元資料同步功能作為預覽功能宣布。 你可以啟用新的元資料同步流程，這只適用於新的 SQL 分析端點。 新的元資料同步選項能讓資料在抵達湖邊小屋後幾秒內保持查詢可行。

新的元資料同步流程包含以下功能：

• 一種新的外部資料表架構，用於解析 Delta 日誌並建立目錄。
• 一種解耦架構，能分別偵測結構與資料變更並相應刷新目錄。
• 背景更新會定期檢查資料更新。
• 當有讀取查詢時，系統偵測到資料不新鮮，需按需刷新資料。

啟用新的元資料同步

你可以透過在工作區設定中的倉庫設定中啟用新的元資料同步。

當你啟用新的元資料同步時，工作空間中的新 SQL 分析端點在刷新底層資料表變更時會更快同步。 目前，該工作區中現有的 SQL 分析端點仍維持在舊版的元資料同步系統。

找出中繼資料上次更新的時間

如果你使用的是新版本的元資料同步，你可以使用動態管理視圖（DMV）來取得 SQL 分析端點最新更新的詳細資訊。 使用 sys.dm_db_external_tables_log_status DMV 查詢最新的元資料同步細節：

• last_update_time_utc：資料表上次以新資料更新時的時間戳記。
• latest_log_version：已更新之資料表的最高 Delta 交易記錄版本。
• latest_checkpoint_version：最新已處理的 Delta 檢查點版本。
• is_blocked： 表示上次嘗試更新資料表是被阻擋（1）還是成功（0）。

欲了解更多資訊，請參見 sys.dm_db_external_tables_log_status。

新元資料同步的限制

• 新的中繼資料同步不支援多部分檢查點，這是已棄用的 Delta 功能。 如果您的 Lakehouse 資料表包含多部分檢查點，這些資料表將無法在新的中繼資料同步機制中更新。
• 如果您的工作區使用工作區私人連結，目前便無法啟用新的中繼資料同步功能。

手動刷新

除了自動更新資料的背景程序外，你還可以手動刷新元資料：

• 從入口網站刷新：在Fabric入口網站的 SQL 分析端點編輯器中，選擇 Explorer工具列中的 Refresh 圖示，強制按需進行元資料同步。到你的 SQL 分析端點 Query，然後在工具列裡找「刷新」按鈕。

  

• 使用 REST API 刷新：使用 Refresh SQL 端點 REST API 程式化地刷新 SQL 分析端點的元資料。

• 透過儲存程序刷新：使用 sys.sp_dw_refresh_ext_table系統儲存程序 來刷新 SQL 分析端點中特定資料表的資料。 此 T-SQL 方法僅在啟用 新元資料同步（預覽）後建立 SQL 分析端點時可用。 例如：

  EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";
  

只有在結構變更時才使用 API，例如新增或刪除資料表或欄位，或更改欄位類型，且需要重新整理整個項目。 對於 SQL 分析端點中僅有資料的變更，請使用 sys.sp_dw_refresh_ext_table 系統儲存程序更新特定資料表。

關於調整底層 Delta 資料表以獲得最佳的元資料同步與查詢效能，請參見 SQL 分析端點效能考量。

相關內容

• SQL 分析端點效能考量
• Lakehouse SQL 分析端點的使用案例
• 重新整理 SQL 端點中繼資料 REST API
• 湖倉儲資料表維護
• Delta Lake 資料表最佳化和 V 順序
• SQL 分析端點中的資料型別