OneLake 捷徑

Microsoft OneLake 的捷徑能將你的資料統一到不同網域、雲端和帳戶，讓 OneLake 成為整個企業的單一虛擬資料湖。 Fabric 體驗與分析引擎可透過統一命名空間連接您現有的資料來源，包括 Azure、Amazon Web Services（AWS）及 OneLake。 OneLake 會管理所有權限與憑證，因此您無需個別設定每個 Fabric 工作負載即可連線每個資料來源。 此外，您可使用捷徑來消除資料邊緣副本，減少與資料副本及分段相關的流程延遲。

什麼是捷徑？

OneLake 的捷徑是代表其他儲存位置的物件。 位置可位於 OneLake 內部或外部。 捷徑指向的位置就是捷徑的 目標路徑 。 捷徑出現的位置就是 捷徑路徑。

捷徑會顯示為 OneLake 資料夾，任何具 OneLake 存取權的工作負載或服務均可使用。 捷徑的運作方式就像符號連結。 其為獨立於目標的物件。 若刪除捷徑，目標將不受影響。 若移動、重新命名或刪除目標路徑，則捷徑可能中斷。

可在何處建立捷徑？

您可在 lakehouse 與 Kusto 查詢語言 (KQL) 資料庫建立捷徑。

你可以用 Fabric 入口網站互動式建立捷徑，也可以用 REST API 程式化建立捷徑。

Lakehouse

在 lakehouse 建立捷徑時，您必須了解項目資料夾結構。 湖倉擁有兩個頂層資料夾：Tables 資料夾和 Files 資料夾。 tables 資料夾是用來存放結構化資料集的。 檔案資料夾是存放非結構化或半結構化資料的。

在 tables 資料夾裡，你只能在最頂層建立捷徑。 OneLake 不支援 tables 資料夾子目錄中的捷徑。 資料表區段中的捷徑通常指向 OneLake 內的內部來源或連結到符合 Delta 資料表格式的其他資料資產。 若捷徑目標包含 Delta Parquet 格式的資料，湖屋會自動同步元資料並識別該資料夾為資料表。 資料表區段中的捷徑可以連結至單一資料表或結構描述，結構描述是多個資料表的父資料夾。

請注意

Delta 格式不支援名稱包含空格字元的資料表。 OneLake 不會將名稱中包含空格的捷徑當作湖屋中的 Delta 表格。

在檔案資料夾裡，沒有限制你可以在哪裡建立捷徑。 你可以在資料夾階層的任何層級建立捷徑。 資料表發現不會發生在檔案資料夾裡。 這些捷徑可以指向內部的 OneLake 儲存系統，也可以指向外部包含任何格式資料的儲存系統。

KQL 資料庫

當您在 KQL 資料庫中建立快捷方式時，它會出現在資料庫的 Shortcuts 資料夾中。 KQL 資料庫會視捷徑為外部資料表。 若要查詢捷徑，請使用 Kusto 查詢語言的 external_table 函式。

可在何處存取捷徑？

可在 OneLake 存取資料的任何 Fabric 或非 Fabric 服務均可使用捷徑。 對於任何透過 OneLake API 存取資料的任何服務，捷徑均為透明。 捷徑僅顯示為資料湖中的另一個資料夾。 Apache Spark、SQL、即時智慧與 Analysis Services 均可在查詢資料時使用捷徑。

Apache Spark

Apache Spark 筆記本與 Apache Spark 工作可使用您在 OneLake 建立的捷徑。 使用相對檔案路徑直接從捷徑讀取資料。 此外，如果您在 Lakehouse 的 [ 資料表 ] 區段中建立快捷方式，而且它採用 Delta 格式，您可以使用 Apache Spark SQL 語法將其讀取為受控數據表。

df = spark.read.format("delta").load("Tables/MyShortcut")
display(df)

df = spark.sql("SELECT * FROM MyLakehouse.MyShortcut LIMIT 1000")
display(df)

SQL

您可以透過 Lakehouse 的 SQL 分析端點，在 Lakehouse 的 [ 資料表 ] 區段中讀取快捷方式。 您可透過 lakehouse 的模式選擇器或透過 SQL Server Management Studio (SSMS) 來存取 SQL 分析端點。

SELECT TOP (100) *
FROM [MyLakehouse].[dbo].[MyShortcut]

即時智能

KQL 資料庫捷徑會識別為外部資料表。 若要查詢捷徑，請使用 Kusto 查詢語言的 external_table 函式。

external_table('MyShortcut')
| take 100

Analysis Services

您可以在 Lakehouse 的 數據表 區段中，為含有快捷方式的 Lakehouse 建立語義模型。 當語意模型以 Direct Lake 模式執行時，Analysis Services 可直接從捷徑讀取資料。

非 Fabric 服務

Fabric 以外的應用程式與服務也可透過 OneLake API 存取捷徑。 OneLake 支援 ADLS Gen2 與 Blob 儲存 API 子集。 若要深入瞭解 OneLake API，請參閱 使用 API 存取 OneLake。

https://onelake.dfs.fabric.microsoft.com/MyWorkspace/MyLakhouse/Tables/MyShortcut/MyFile.csv

捷徑類型

OneLake 捷徑支援多個檔案系統資料來源。 這些來源包括 OneLake 內部地點以及外部或非 Microsoft 來源。

您也可以透過 Fabric 本地資料閘道（OPDG） 建立通往本地或網路限制地點的捷徑 。

內部 OneLake 平台捷徑

使用內部 OneLake 捷徑來引用現有 Fabric 項目中的資料，包括：

• KQL 資料庫
• 湖畔別墅
• 鏡像化的 Azure Databricks 目錄
• 鏡像資料庫
• 語意模型
• SQL 資料庫
• 倉儲

關於建立內部捷徑的說明，請參見 「建立內部 OneLake 捷徑」。

捷徑可以指向同一項目中的資料夾位置、相同工作區的不同項目，或甚至是跨不同工作區的項目。 當您跨項目建立捷徑時，項目類型不需匹配。 例如，你可以在湖屋（lakehouse）中建立一個捷徑，用來指向資料倉儲中的資料。

當使用者透過捷徑從其他 OneLake 地點存取資料時，OneLake 會使用呼叫使用者的身份授權存取資料。 此使用者必須在目標位置具有權限才能讀取資料。

重要

當使用者透過 DirectLake 經由 SQL 或 T-SQL 引擎在委派身份模式下存取 Power BI 語意模型的捷徑時，呼叫使用者的身份不會被傳遞至捷徑目標。 取而代之的是，通話項目的擁有者身份會被傳遞，並將存取權委派給呼叫使用者。 為了解決這個限制，可以在 DirectLake 模式中使用 Power BI 語意模型 ，而非 OneLake ，或在 使用者身份模式下使用 T-SQL。

外部 OneLake 捷徑

如需詳細說明如何建立特定捷徑類型，請從以下支援的外部來源列表中選擇一篇文章：

• Amazon S3 捷徑
• Amazon S3 相容的捷徑
• Azure Data Lake Storage（ADLS）Gen 2 快捷方式
• Azure Blob Storage 快捷方式
• Dataverse 捷徑
• Google Cloud Storage 捷徑
• 冰山捷徑
• OneDrive 與 SharePoint 捷徑

緩存

快取捷徑可以減少與跨雲端資料存取相關的網路流量成本。 當 OneLake 透過外部捷徑讀取檔案時，服務會將檔案儲存在 Fabric 工作區的快取中。 OneLake 回應快取中後續的讀取請求，而非遠端的儲存提供者。 你可以設定快取檔案的保留期在 1 到 28 天之間。 每次存取檔案時，保留期限都會被重置。 如果遠端儲存提供的檔案版本比快取版本更新，OneLake 會接收遠端儲存提供者的請求並更新快取中的檔案。 如果你在選擇的保留期內沒有存取檔案，該檔案會從快取中被清除。 不會快取大小大於 1 GB 的個別檔案。

請注意

捷徑快取目前支援 Google Cloud Storage（GCS）、S3、S3 相容性及本地資料閘道捷徑。

若要啟用快捷方式的快取，請開啟 [工作區設定 ] 面板。 選擇 [OneLake] 索引標籤 。將快取設定切換為 [開啟 ]，然後選取 [ 保留期間]。

你隨時都可以清除快取。 從相同的設定頁面中，選取 [重設快取] 按鈕。 此動作會從此工作區的快捷方式快取中移除所有檔案。

捷徑如何使用雲端連線

ADLS 和 S3 捷徑透過雲端連線來委派授權。 當建立新 ADLS 或 S3 捷徑時，您可建立新連線或為資料來源選取現有連線。 設定捷徑連線是一種綁定操作。 僅具連線權限的使用者才能執行繫結操作。 如果你沒有該連線的權限，就無法用該連線建立新的捷徑。

欲了解更多關於查看與更新雲端連線的資訊，請參閱 「管理連線」中的捷徑。

快捷方式安全性

需要某些權限才能管理及使用捷徑。 OneLake 捷徑安全性 說明了建立捷徑並透過捷徑存取資料所需的權限。

捷徑如何處理刪除操作？

捷徑不支援層疊刪除。 當您刪除捷徑時，只會刪除捷徑物件。 捷徑目標中的資料保持不變。 然而，如果你在捷徑中刪除了檔案或資料夾，且捷徑目標有執行刪除操作的權限，你也會刪除該目標中的檔案或資料夾。

例如，考慮一個 Lakehouse，其內包含以下路徑：MyLakehouse\Files\MyShortcut\Foo\Bar。 MyShortcut 是指向包含 Foo\Bar 目錄的 ADLS Gen2 帳戶的快捷方式。

如果你刪除 MyLakehouse\Files\MyShortcut，你也會刪除湖屋裡的 MyShortcut 捷徑，但 ADLS Gen2 帳號 Foo\Bar 裡的檔案和目錄就不會受影響。

如果你刪除 MyLakehouse\Files\MyShortcut\Foo\Bar了 ，且你在 ADLS Gen2 帳號中有寫入權限，你就會從 ADLS Gen2 帳號中刪除 Bar 目錄。

工作區譜系檢視

當你在工作區內多個 Fabric 項目間建立捷徑時，可以透過工作區的血統視圖視覺化這些捷徑關係。 選取 [工作區總管] 右上角的 [歷程檢視 ] 按鈕 （ ）。

請注意

譜系檢視範圍僅限單一工作區。 選取工作區外部位置的快捷方式不會出現。

限制與考量

• 每個 Fabric 元件最多支援10萬個捷徑。 在此語境中，項目指的是應用程式、湖畔住宅、倉庫、報告等。
• 單一 OneLake 路徑最多支援 10 條捷徑。
• 直接捷徑到捷徑連結的數量上限為 5 個。
• OneLake 捷徑名稱、上層路徑與目標路徑不能包含「%」或「+」字元。
• 捷徑不支援非拉丁字元。
• 目前無法使用數據倉儲和語意模型的快捷方式譜系。
• 網狀架構快捷方式幾乎會立即與來源同步，但傳播時間可能會因為數據源效能、快取檢視或網路連線問題而有所不同。
• 數據表 API 最多可能需要一分鐘的時間才能辨識新的快捷方式。

相關內容

• 建立 OneLake 快捷方式
• 使用 OneLake 快捷方式 REST API