使用 OneLake 檔案總管來存取 Fabric 資料

OneLake 檔案總管應用程式可順暢地整合 OneLake 與 Windows 檔案總管。 此應用程式會自動同步處理您在 Windows 檔案總管 中有權存取的所有 OneLake 項目。 「同步處理」是指在檔案和資料夾上提取最新的中繼資料，並將本機所做變更傳送至 OneLake 服務。 同步處理不會下載資料，而是會建立預留位置。 您必須按兩下檔案，才能在本機下載資料。

重要

此功能處於預覽。

當您透過 Windows 檔案總管建立、更新或刪除檔案時，會自動將變更同步處理至 OneLake 服務。 在檔案總管外部進行的項目更新不會經過自動同步處理。 若要提取這些更新，您必須以滑鼠右鍵按一下 Windows 檔案總管中的項目或子資料夾，然後選取 [從 OneLake 同步]。

安裝指示

OneLake 檔案總管目前支援 Windows，且已在 Windows 10 和 11 上通過驗證。

安裝方式：

1. 下載 OneLake 檔案總管。

2. 按兩下檔案以啟動安裝。

   您電腦上的預留位置儲存位置，且任何下載內容都是 \%USERPROFILE%\OneLake - Microsoft\。

安裝並啟動應用程式之後，您現在可以在 Windows 檔案總管中看到您的 OneLake 資料。

自 1.0.13 版起，OneLake 檔案總管應用程式現在會在有新的更新可用時通知您。 當有新版本可用時，您會收到 Windows 通知，且 OneLake 圖示將會變更。 以滑鼠右鍵按一下 Windows 通知區域中的 OneLake 圖示。 選取 [可用的更新]，然後遵循步驟進行更新。

限制與考量

• 具有 "/" 字元的工作區名稱、編碼的逸出字元 (例如 %23)，以及看起來像 GUID 的名稱無法同步處理。

• 包含 Windows 保留字元的檔案或資料夾 (深入瞭解) 無法同步處理。

• 如果 Windows Search 已停用，則無法啟動 OneLake 檔案總管。

• Windows 檔案總管不區分大小寫，而 OneLake 會區分大小寫。 您可以使用其他工具，在 OneLake 服務中建立具有相同名稱但不同大小寫的檔案，不過 Windows 檔案總管 只會顯示其中一個檔案 (最舊檔案)。

• 如果檔案因為網路問題而無法同步處理，您必須觸發對 OneLake 的同步。 您可以開啟檔案並加以儲存，以提示同步處理程序執行此動作。 或者，您可以執行下列命令，使用 PowerShell 觸發修改事件：(Get-Item -Path "<file_path>").LastWriteTimeUtc = Get-Date

案例

下列案例提供使用 OneLake 檔案總管的詳細資料。

啟動和結束 OneLake 檔案總管

OneLake 檔案總管會在 Windows 啟動時自動啟動。 您可以選取 Windows 工作管理員中的 [啟動應用程式]，然後以滑鼠右鍵按一下 [OneLake]，然後選取 [停用]，以停用應用程式的自動啟動功能。

• 若要手動啟動應用程式，請使用 Windows Search (Windows+S) 來搜尋 OneLake ，然後選取 OneLake 應用程式。 先前同步之任何資料夾的檢視會自動重新整理。

• 若要結束，請以滑鼠右鍵按一下 Windows 通知區域中的 OneLake 圖示，其位於工作列最右側，然後選取 [結束]。 同步會暫停，而且您無法存取預留位置檔案和資料夾。 您會繼續看到先前同步但尚未下載之預留位置的藍色雲端圖示。

從 OneLake 同步處裡更新

為了在初始同步處理期間最佳化效能，OneLake 檔案總管會同步處理最上層工作區和項目名稱的預留位置檔案。 當您開啟項目時，OneLake 檔案總管會直接同步處理該資料夾中的檔案。 然後，在項目內開啟資料夾會直接同步該資料夾中的檔案。 這項功能可讓您順暢地瀏覽 OneLake 內容，而不需要等待所有檔案同步處理完畢才開始使用。

當您透過 OneLake 檔案總管建立、更新或刪除檔案時，會自動將變更同步處理至 OneLake 服務。 在 OneLake 檔案總管外部進行的項目更新不會經過自動同步處理。 若要提取這些更新，您必須以滑鼠右鍵按一下 OneLake 檔案總管中的工作區名稱、項目名稱、資料夾名稱或檔案，然後選取 [從 OneLake 同步]。 此動作會重新整理先前同步之任何資料夾的檢視。 若要提取所有工作區的更新，請以滑鼠右鍵按一下 OneLake 根資料夾，然後選取 [從 OneLake 同步]。

登入不同的帳戶

自 1.0.9.0 版起，當您安裝 OneLake 檔案總管時，可以選擇要登入的帳戶。 若要切換帳戶，請以滑鼠右鍵按一下 Windows 通知區域中的 OneLake 圖示，依序選取 [帳戶] 和 [登出]。登出會結束 OneLake 檔案總管，並暫停同步處理。若要使用另一個帳戶登入，請再次啟動 OneLake 檔案總管，然後選擇所需的帳戶。

當您使用另一個帳戶登入時，您會看到 OneLake 檔案總管中的工作區和項目清單進行重新整理。 如果您瀏覽至與上一個帳戶相關聯的工作區，您可以選取 [從 OneLake 同步] 來手動重新整理檢視。 當您登入不同的帳戶時，將無法存取這些工作區。

在入口網站上開啟工作區和項目的選項

自 1.0.10.0 版起，您可以使用 OneLake 檔案總管與 Fabric 入口網站順暢地進行轉換。 使用 OneLake 檔案總管瀏覽 OneLake 資料時，請以滑鼠右鍵按一下工作區，然後選取 [OneLake->在線上檢視工作區]。 這會在 Fabric 入口網站上開啟工作區瀏覽器。
此外，您能夠以滑鼠右鍵按一下項目、子資料夾或檔案，然後選取 [OneLake->在線上檢視項目]。 這會在 Fabric 入口網站上開啟項目瀏覽器。 如果您選取子資料夾或檔案，Fabric 入口網站一律會開啟項目的根資料夾。

離線支援

OneLake 檔案總管只會在您上線且正在執行應用程式時同步處理更新。 當應用程式啟動時，先前同步之任何資料夾的檢視會自動重新整理。 離線時新增或更新的任何檔案都會顯示為擱置同步，直到您再次加以儲存為止。 如果離線時刪除的任何檔案仍存在於服務上，則會在重新整理期間重新建立。

在 OneLake 檔案總管中建立檔案或資料夾

1. 瀏覽至 Windows 檔案總管中的 OneLake 區段。

2. 瀏覽至您項目中的適當資料夾。

3. 以滑鼠右鍵按一下並選取 [新增資料夾] 或 [新增檔案類型]。

注意

如果您將資料寫入至沒有寫入權限的位置 (例如項目或工作區的根目錄)，同步處理將會失敗。 將檔案或資料夾移至正確的位置或刪除檔案，即可清理無法同步的檔案或資料夾。

刪除 OneLake 檔案總管中的檔案或資料夾

1. 瀏覽至 Windows 檔案總管中的 OneLake 區段。

2. 瀏覽至項目中的 [檔案] 或 [資料表] 資料夾。

3. 選取檔案或資料夾並刪除。

編輯檔案

您可以使用您最愛的應用程式開啟檔案，並進行編輯。 選取 [儲存] 會將檔案同步至 OneLake。 自 1.0.11 版起，您也可以使用 Excel 對檔案進行更新。 在 Excel 中進行更新之後關閉檔案，即可起始與 OneLake 的同步處理。

因為您上次選取了 [從 OneLake 同步]，所以如果在本機編輯檔案並選取 [儲存]，OneLake 檔案總管應用程式會偵測該檔案是否已在其他地方更新 (由其他人更新)。 [確認動作] 對話方塊隨即出現：

因為您上次選取了 [從 OneLake 同步]，所以如果選取 [是]，則本機變更會覆寫對檔案進行的任何其他變更。

如果您選取 [否]，則不會將本機變更傳送至 OneLake 服務。 然後，您可以選取 [從 OneLake 同步] 來還原本機變更，並從服務提取檔案。 或者，您可以使用新的名稱複製檔案以避免衝突。

複製或移動檔案

您可以使用 Ctrl+C 和 Ctrl+V 等標準鍵盤快速鍵，將檔案複製到項目、從項目複製檔案，以及在項目內複製貼上檔案。 您也可以藉由拖放來移動檔案。

支援大型檔案和大量檔案

當您使用 OneLake 檔案總管上傳或下載檔案時，效能應該與使用 OneLake API 持平。 一般而言，從 OneLake 同步變更所需的時間與檔案數目成正比。

OneLake 捷徑支援

您的項目中的所有資料夾 (包括 OneLake 捷徑) 都是可見的。 您可以檢視、更新和刪除這些捷徑中的檔案和資料夾。

用戶端記錄

自 1.0.10 版起，您可以在工作列最右側的 Windows 通知區域中，以滑鼠右鍵按一下 OneLake 圖示來尋找用戶端記錄。 選取 [診斷作業]>[開啟記錄目錄]。 這會在新的 Windows 檔案總管視窗中開啟您的記錄目錄。

用戶端記錄會儲存在本機電腦的 %temp%\OneLake\Diagnostics\ 底下。

您可以選取 [診斷作業]>[啟用追蹤] 來啟用其他用戶端記錄。

版本資訊

自 1.0.11 版起，您可以在工作列最右側的 Windows 通知區域中，以滑鼠右鍵按一下 OneLake 圖示，找到 OneLake 檔案總管每個版本的相關資訊。 選取 [關於]>[版本資訊]。 這會開啟瀏覽器視窗中的 OneLake 檔案總管版本資訊頁面。

解除安裝指示

若要解除安裝應用程式，請在 Windows 中搜尋 OneLake。 在 OneLake 下的選項清單中選取 [解除安裝]。

租用戶設定可讓您存取 OneLake 檔案總管

租用戶系統管理員可以在 Microsoft Fabric 管理員入口網站中限制組織的 OneLake 檔案總管存取權。 停用該設定時，組織中的任何人都無法啟動 OneLake 檔案總管應用程式。 如果應用程式已經執行，且租用戶系統管理員停用設定，則應用程式會結束。 預留位置和任何下載內容會保留在本機電腦上，但使用者無法與 OneLake 同步處理資料。

OneLake 檔案總管圖示

這些 OneLake 檔案總管圖示會出現在 Windows 檔案總管內，以指出檔案或資料夾的同步狀態。

圖示	圖示描述	意義
	藍色雲端圖示	檔案只能在線上使用。 線上專屬檔案不會佔用您電腦上的空間。
	綠色勾號	檔案會下載至本機電腦。
	同步擱置箭號	同步進行中。 上傳檔案時，可能會顯示此圖示。 如果同步擱置箭號持續出現，則您的檔案或資料夾可能出現同步處理錯誤。 您可以在本機電腦 %temp%\OneLake\Diagnostics\ 下的用戶端記錄中找到詳細資訊。

相關內容

• 深入瞭解 Fabric 和 OneLake 安全性。
• 最新 OneLake 檔案總管的新增功能