語意模型的 OneLake 整合

重要

語意模型的 OneLake 整合目前預覽版。

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

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

在組織中實作 OneLake 整合解決方案之前，請務必閱讀本文稍後考慮和限制。

必要條件

語意模型的 OneLake 整合僅在 Power BI Premium P 和 Microsoft Fabric F SKU 上受支援。 Power BI Pro、Premium Per User 或 Power BI Embedded A/EM SKU 不支援該功能。

啟用 OneLake 整合之前，您必須具備：

• Power BI Premium 或 Fabric 容量上工作區中的一或多個匯入語意模型。
• 為模型啟用 [大型語意模型儲存格式]。

權限

模型參與者 (讀取、寫入、探索) 權限，才能存取模型資料夾的內容，並建立連結至 Lakehouse 檔案總管中資料夾的捷徑。

啟用 OneLake 整合

在語意模型設定中，展開 OneLake 整合，按兩下滑桿以 On，然後選取 [套用]。

管理員入口網站

全域和租用戶系統管理員可以使用 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 檔案和記錄檔。

   

捷徑

藉由為語意模型 Lakehouse 資料表建立捷徑，您可以快速輕鬆地從 Fabric 中的其他工作負載存取。

1. 在 Lakehouse Explorer 中，以滑鼠右鍵按兩下 [資料表]，然後選取 [新增捷徑]。

2. 在 [新增捷徑]中，選取 [Microsoft OneLake]。

3. 在 [選取資料來源類型]，選取您的語意模型，然後選取您想要包含的資料表。

   

考量與限制

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

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

• 在預覽期間，在 Lakehouse 中匯出模型之上建置的捷徑資料表無法使用 SQL 端點來查詢。

• 在預覽期間，尚不支援多地理位置容量。

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

• 對於具有導出模型資料表之參與者權限但僅限檢視者工作區權限的使用者，模型資料夾會出現在 Lakehouse 總管中，但選取時會傳回錯誤。

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

• 只有單一版本的差異資料表會導出並儲存在 OneLake 上。 成功匯出之後，會刪除舊版的差異資料表。 其他使用較舊但現在已刪除資料版本的執行引擎可能會發生暫時性失敗。

相關內容

• 什麼是 OneLake？
• OneLake 檔案總管概觀