全部產品
Search
文件中心

Data Lake Formation:資源回收筒

更新時間:Aug 25, 2026

資料湖構建(Data Lake Formation,簡稱 DLF)提供資源回收筒功能,用於降低誤刪資料庫、表以及檔案的風險。刪除資料庫或表後,相關資料和中繼資料會先保留在資源回收筒中,在保護期內可查詢並還原。對於 Paimon Catalog,資源回收筒還支援查看湖表最佳化清理的孤兒檔案。

使用情境

  • 誤刪除資料庫或資料表後,在中繼資料保護期內可還原。

  • 湖表最佳化孤兒檔案清理的無引用檔案可進入檔案資源回收筒,用於問題排查。詳見廢棄檔案清理。

前提條件

  • 許可權配置: 當前帳號具備進入資料湖構建控制台、查看資源回收筒和還原資源的許可權。RAM 使用者還需具備 DLF 相關的 API 和資料許可權,具體操作請參見 快速配置許可權。

  • Catalog 狀態: Catalog 處於可訪問狀態。若 Catalog 不存在、已刪除、無許可權訪問或狀態不可用,還原作業會失敗,資源回收筒中的資料和中繼資料不會發生變化。

使用限制

  • 檔案回收範圍: 檔案回收功能僅適用於 Paimon 類型的 Catalog,且 Catalog 需已完成系統初始化。其他類型 Catalog 不支援檔案回收。

  • 保護期限制: 中繼資料保護期到期後,資料和中繼資料不可恢複。即使頁面仍短暫顯示為清理中,也不能再執行還原作業。

  • 同名衝突: 還原資料庫或資料表時,如果目標位置已有同名且狀態正常的資料庫或資料表,還原會失敗。請先處理同名資源,再重新執行還原。

  • 父庫依賴: 還原資料表要求父資料庫處於正常狀態。如果父資料庫在資源回收筒中,請先還原父資料庫。

  • 清理中狀態: 清理中狀態下不能再執行還原作業,需等待後台清理完成後重試(通常約 30 分鐘)。

操作步驟

步驟一:配置資源回收筒保留期

  1. 登入資料湖構建控制台

  2. 在左側導覽列,選擇数据目录。

  3. 在 Catalog 列表中,單擊目標 Catalog。

  4. 在 Catalog 詳情頁面,單擊目录配置。

  5. 在高级配置地區,單擊编辑。

  6. 在屬性配置地區(Catalog Properties)中新增或修改資源回收筒相關配置項。

  7. 單擊确定。

資源回收筒相關配置項說明如下。

配置項

類型

預設值

說明

dlf.trashed-meta-retained-days

Integer

1

資料庫、資料表等中繼資料在資源回收筒中的保護天數。必須為大於等於 1 的整數。保護期內允許還原;到期後相關資料和中繼資料進入不可還原的清理階段。

dlf.trashed-file-retained-days

Integer

7

系統資源回收筒(system.trash)中孤兒檔案的保留天數。必須為非負整數。配置為 0 表示不啟用檔案回收。

步驟二:進入資源回收筒頁面

  1. 登入資料湖構建控制台

  2. 在左側導覽列,選擇系统和安全。

  3. 在系統和安全頁面,單擊回收站。

  4. 根據需要選擇数据库、数据表或文件分類。

步驟三:還原資料庫或資料表

  1. 在資源回收筒頁面,選擇数据库或数据表分類。

  2. 選擇目標 Catalog,並按需輸入資料庫或資料表名稱進行篩選。

  3. 找到需要恢複的資料庫或資料表。

  4. 確認狀態為删除保护中。

  5. 在操作列,單擊还原。

步驟四:查看回收檔案

  1. 在資源回收筒頁面,選擇文件分類。

  2. 選擇目標 Catalog,並按需輸入檔案名稱或路徑關鍵字進行篩選。

  3. 查看被刪除的檔案資訊。

說明

檔案分類展示的是系統資源回收筒(system.trash)中的孤兒檔案,僅支援查看,不支援還原。

注意事項

  • 保留期獨立: 中繼資料保護期(dlf.trashed-meta-retained-days)和檔案保留期(dlf.trashed-file-retained-days)是兩個獨立的配置項。前者控制資料庫、表等中繼資料及資料可還原的時間;後者控制系統資源回收筒中孤兒檔案的保留時間。

  • 還原聯動: 還原資料庫時,隨資料庫一起進入資源回收筒的庫內資料表會一併恢複。此前單獨刪除的資料表需在資料表分類中單獨還原。

  • 後台清理: 刪除資料庫或表後,相關資料和中繼資料會先進入資源回收筒。永久刪除由後台清理任務完成,具體完成時間取決於配置的保護期和後台清理調度。

常見問題

為什麼查詢資源回收筒時看到"清理中"?

資料和中繼資料已超過中繼資料保護期,進行中後台清理。清理中狀態通常持續約 30 分鐘,該狀態下不能再執行還原作業。