共用方式為


語意模型的 OneLake 整合功能

重要

OneLake 與語意模型的整合目前處於 預覽階段

透過 Microsoft OneLake 與語意模型的整合,匯入至模型的數據表的數據也可以自動寫入 OneLake 中的 Delta 數據表。 Delta 格式是 Microsoft Fabric 中所有計算引擎的統一數據表格式。 OneLake 整合會匯出已啟用所有重要效能功能的數據,以提供效能更高的順暢數據存取。

數據科學家、資料庫分析師、應用程式開發人員、數據工程師和其他數據取用者接著可以存取在 Power BI 中驅動商業智慧和財務報告的相同數據。 T-SQL、Python、Scala、PySpark、Spark SQL、R 和無程式代碼/低程式代碼解決方案都可以用來查詢 Delta 數據表的數據。

OneLake 整合於語意模型的圖表

在組織中實作 OneLake 整合解決方案之前,請務必閱讀本文稍後 考量與限制事項

先決條件

語意模型的 OneLake 整合僅限於 Power BI Premium P 和 Microsoft Fabric F SKU。 此功能不適用於 Power BI Pro、Power BI Premium Per User 或 Power BI Embedded A/EM SKU。

啟用 OneLake 整合之前,您必須具備:

權限

要存取模型資料夾的內容並在 Lakehouse 資料夾瀏覽器中建立連接捷徑,需要模型 參與者 的(讀取、寫入、探索)權限。

啟用 OneLake 整合

在語意模型設定中,展開 OneLake 整合,將滑桿調至 On,然後選取 套用

在模型設定中啟用 OneLake 整合。

管理平台

全域和租用戶系統管理員可以使用Power BI管理入口網站中的下列設定來控制 OneLake 整合:

管理入口網站的租用戶設定螢幕快照。

  • 語意模型可以將數據匯出至 OneLake - 在組織層級啟用 OneLake 整合。 如果停用,使用者就無法開啟其語意模型的 OneLake 整合,且目前為 OneLake 整合設定的任何語意模型都停止將匯入數據表導出至 OneLake。 依預設會針對整個組織啟用 OneLake 整合。

  • 使用者可以將語意模型數據表儲存在 OneLake - 可讓組織中的所有或選取的使用者設定其語意模型的 OneLake 整合。 如果針對特定使用者停用,該使用者就無法再開啟 OneLake 整合,但是他們為 OneLake 整合設定的任何語意模型會繼續將匯入數據表導出至 OneLake。 該使用者可以針對已針對 OneLake 整合設定的語意模型停用 OneLake 整合,但無法重新啟用 OneLake 整合。 此設定需要 語意模型可以將數據匯出至要啟用的 OneLake 租用戶設定。 根據預設,組織中的所有使用者都可以為其語意模型設定 OneLake 整合。

重新整理模型

為了讓模型匯入數據寫入 OneLake 中的 Delta 表格,必須執行至少一次手動或排程的模型刷新。 執行手動重新整理或等候排程的重新整理作業。

匯出 OneLake Delta 數據表

增量表可以透過許多方式匯出。 如果您的語意模型已啟用 XMLA 讀寫模式,您可以使用 表格式物件模型 (TOM)表格式模型腳本語言 (TMSL),以程式設計方式導出。

例如,您可以使用 SQL Server Management Studio (SSMS) 來執行下列 TMSL 命令:

{  
 "export": {  
   "layout": "delta",
   "type": "full",  
   "objects": [  
     {  
       "database": "<database name>"  
     }  
   ]  
 }  
}

探索匯出檔案

匯出之後,您可以使用 OneLake 檔案總管,其整合 OneLake 與 Windows 檔案總管,以找出 Delta 數據表導出檔案。。

  1. 在 OneLake 檔案總管中,以滑鼠右鍵按兩下工作區資料夾,然後從 OneLake選取 [Sync]。

  2. 使用 Windows 檔案總管來找出數據檔。 在工作區資料夾中,尋找名稱符合語意模型的子資料夾,並以 結尾。SemanticModel。 語義模型資料夾中包含每個匯入模式數據表子資料夾,這些子資料夾中包含 Delta 表格的 parquet 檔案和日誌。

    SSMS 中的TMSL匯出命令。

快捷方式

藉由為語意模型 Lakehouse 資料表建立 快捷方式,您可以快速輕鬆地從 Fabric 中的其他工作流程存取它們。

  1. 在 Lakehouse Explorer 中,以滑鼠右鍵點擊 [數據表],然後選取 [新增捷徑] 。

  2. 新增快捷方式中,選取 Microsoft OneLake

  3. 選取數據來源類型,選取您的語意模型,然後選取您想要包含的數據表。

    在檔案總管中 OneLake 快捷方式

考量事項與限制

  • 在預覽期間,值大於18個小數點的貨幣數據類型在導出至 Delta 檔案時可能會有一些精確度遺失。

  • 在預覽期間,BYOK 已啟用的工作區不支援語義模型。

  • 在預覽期間,在 Lakehouse 中匯出模型之上建置的快捷方式數據表無法使用 SQL 端點來查詢。

  • 在預覽期間,尚不支援 多地理 功能。

  • 在預覽期間,不會計費將模型導出至 OneLake 的作業,但會收取在 OneLake 上匯出模型的計算和儲存使用量

  • 對於具有導出模型資料表之 參與者 許可權,但在工作區中只有 檢視者 許可權的使用者,模型資料夾會出現在 Lakehouse 總管中,但選取時會顯示錯誤。

  • 量值、DirectQuery 數據表、混合式數據表、計算群組數據表和系統管理的匯總數據表無法匯出至 Delta 格式數據表。

  • 只有單一版本的 delta 表格會被導出並儲存在 OneLake 上。 成功匯出後,會刪除舊版的 Delta 表格。 其他使用較舊但現在已刪除數據版本的執行引擎可能會發生暫時性失敗。