在 OneLake 中設定檔案層級的軟刪除

OneLake 檔案層級軟刪除透過保留已刪除檔案來保護您的資料,避免永久移除。 軟刪除預設為每個工作區開啟,保留期限為七天。 你可以開啟或關閉軟刪除,並將保留期限設定為 1 到 365 天。

你支付軟刪除資料的費用與活躍資料相同。 設定保留期以平衡復原需求與儲存成本。

先決條件

  • 工作區管理員角色。

在 Fabric 入口網站設定軟刪除

從 OneLake 設定中設定工作區的檔案層級軟刪除。

  1. 在 Fabric 入口網站中開啟工作區。

  2. 選擇 工作區設定>OneLake>General。

  3. 使用 啟用檔案層級軟刪除 的開關來開啟或關閉保留。

    Fabric 入口網站的截圖,顯示在 Workspace 設定中啟用檔案層級軟刪除。

  4. 若開啟保留,則將 保留期間 設為1至365天。

開啟保留後,保留期限預設為七天。 此設定適用於整個工作區的檔案,但不影響工作區或項目的保留。

使用 REST API 來設定軟刪除

使用 Fabric REST API 檢視或更新工作區的檔案層級虛刪除保留設定。

要查看目前的設定,請發送以下請求:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/onelake/settings

當保留啟動時,回應會包含狀態及保留期限:

{
    "enabled": true,
    "retentionDays": 30
}

要更新設定,請向以下端點發送 POST 請求。 要開啟保留並設定保留期限,請使用以下請求主體:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/onelake/settings/modifyFileSoftDelete
{
    "enabled": true,
    "retentionDays": 30
}

要關閉保留,請使用以下請求主體:

{
    "enabled": false
}

只有當 OneLake 更新所有適用的儲存帳號時,更新才會成功。 如果任何帳號無法更新,請求會失敗,帳號會保持同步。

了解留存行為與範圍

保留期限變更僅適用於變更後刪除的檔案。 已軟刪除的檔案會維持刪除時生效的保留期限。 例如,若保留期限從 28 天改為 7 天,變更前刪除的檔案仍可恢復 28 天。 變更後刪除的檔案可恢復七天。

此設定適用於工作區已完全計費的儲存帳戶中的資料,包括預設儲存帳戶及診斷日誌儲存帳戶。 這不適用於未計費或部分計費的儲存帳戶中的資料。 這些帳戶的資料是從另一個資料庫鏡像過來的,並不是真實的來源。

工作區和項目刪除的行為與檔案刪除不同:

  • 當工作區被永久刪除時,其資料會立即被刪除。 檔案層級的軟刪除不適用。
  • 當某個項目被永久刪除時,其資料在 OneLake 中仍可於所設定的檔案層級軟刪除保留期間內復原。