建立同租戶的 OneLake 捷徑

本文將說明如何建立 OneLake 捷徑,使其指向您租戶中另一個 Fabric 項目內的資料。

如需捷徑的概觀,請參閱 OneLake 捷徑。 若要以程序設計方式建立捷徑,請參閱 OneLake 捷徑 REST API。

先決條件

OneLake 中的湖倉或 KQL 資料庫。 如果你沒有這些,請依照以下步驟建立一個測試湖 畔別墅:建立一座湖畔別墅。

建立捷徑

  1. 打開你的Lakehouse平台或KQL資料庫。

  2. 在 檔案總管 窗格中右鍵點擊目錄。

  3. 從選單建立新的捷徑。

    • 在湖屋中,根據你的湖屋設定,選擇 新捷徑、 新資料表捷徑或 新結構捷徑 。
    • 在 KQL 資料庫中,選擇 一個新的OneLake 捷徑。

    截圖顯示從湖區視圖中選擇新捷徑的位置。

  4. 在內部來源中,選取Microsoft OneLake。

    螢幕擷取畫面顯示 [新增捷徑] 視窗中的可用捷徑來源。選項「OneLake」被突出顯示。

  5. 選取要連接的資料來源,然後選取 [下一步]。

    選取資料來源類型視窗的螢幕擷取畫面,其中顯示要搭配捷徑使用的可用資料來源。[下一步] 按鈕受到醒目提示。

    Tip

    如果您想要連線到另一個 Fabric 租戶中的資料,請依照下列步驟建立跨租戶 OneLake 捷徑。

  6. 選擇 連接方式:

    • 直通 (預設):使用每位使用者的身份來存取目標資料。 繼續至下個步驟。

    • 委派身份:使用已設定的連線身份來存取目標資料,而非每位使用者的身份。 如果你選擇這個選項,請選擇 連接 ,然後設定連線。 欲了解更多資訊,請參閱委派認證。

      要設定委派連線:

      1. 選擇 「現有連線 」並從列表中選擇一個連線,或選擇 「新連線 」來建立連線。
      2. 若要建立新連線,請輸入連結細節:
      • 路徑:確認或輸入 OneLake 路徑。
      • 連線:選取 [建立新連線]。
      • 連線名稱:輸入一個可辨識的名稱。
      • 認證類型:選擇 組織帳號 或 服務負責人。
        • 對於 組織帳戶,選擇 登入 並完成驗證。
          • 對於 服務主體,輸入租戶 ID、應用程式(用戶端)ID 及用戶端秘密。
      1. 選取 下一步。
  7. 展開 [檔案] 或 [資料表],即可檢視可用的子資料夾。 資料表目錄中包含有效 Delta 或 Iceberg 資料表的子資料夾會以資料表圖示表示。 資料表區段中的檔案或不明資料夾會以資料夾圖示表示。

    這張截圖顯示了湖邊小屋擴充後的表格和檔案目錄。

  8. 選取一或多個要連線的子資料夾,然後選取 [下一步]。

    在 OneLake 建立捷徑時,最多可以選擇 50 個子資料夾。

    新捷徑視窗的截圖,顯示在湖倉中的資料。

  9. 檢閱所選捷徑位置。 使用編輯動作來變更預設的捷徑名稱。 使用刪除動作來移除任何不需要的選取項目。 選取 [建立] 以產生捷徑。

    [新增捷徑] 視窗的螢幕擷取畫面,其中顯示所選捷徑位置,並提供刪除或重新命名選取項目的選項。

湖倉會自動重新整理。 捷徑會出現在 檔案總管 窗格中所選目錄下方。 您可以從其屬性中區分一般檔案或數據表與快捷方式。 屬性具有 快捷方式類型 參數,指出專案是快捷方式。

截圖顯示一個顯示捷徑符號的 Lake View 資料夾清單。

若要編輯或刪除現有捷徑,請參見 「編輯或刪除 OneLake 捷徑」。