資料湖構建(Data Lake Formation,簡稱 DLF)提供資源回收筒功能,用於降低誤刪資料庫、表以及檔案的風險。刪除資料庫或表後,相關資料和中繼資料會先保留在資源回收筒中,在保護期內可查詢並還原。對於 Paimon Catalog,資源回收筒還支援查看湖表最佳化清理的孤兒檔案。
使用情境
誤刪除資料庫或資料表後,在中繼資料保護期內可還原。
湖表最佳化孤兒檔案清理的無引用檔案可進入檔案資源回收筒,用於問題排查。詳見廢棄檔案清理。
前提條件
許可權配置: 當前帳號具備進入資料湖構建控制台、查看資源回收筒和還原資源的許可權。RAM 使用者還需具備 DLF 相關的 API 和資料許可權,具體操作請參見 快速配置許可權。
Catalog 狀態: Catalog 處於可訪問狀態。若 Catalog 不存在、已刪除、無許可權訪問或狀態不可用,還原作業會失敗,資源回收筒中的資料和中繼資料不會發生變化。
使用限制
檔案回收範圍: 檔案回收功能僅適用於 Paimon 類型的 Catalog,且 Catalog 需已完成系統初始化。其他類型 Catalog 不支援檔案回收。
保護期限制: 中繼資料保護期到期後,資料和中繼資料不可恢複。即使頁面仍短暫顯示為清理中,也不能再執行還原作業。
同名衝突: 還原資料庫或資料表時,如果目標位置已有同名且狀態正常的資料庫或資料表,還原會失敗。請先處理同名資源,再重新執行還原。
父庫依賴: 還原資料表要求父資料庫處於正常狀態。如果父資料庫在資源回收筒中,請先還原父資料庫。
清理中狀態: 清理中狀態下不能再執行還原作業,需等待後台清理完成後重試(通常約 30 分鐘)。
操作步驟
步驟一:配置資源回收筒保留期
登入資料湖構建控制台
在左側導覽列,選擇数据目录。
在 Catalog 列表中,單擊目標 Catalog。
在 Catalog 詳情頁面,單擊目录配置。
在高级配置地區,單擊编辑。
在屬性配置地區(Catalog Properties)中新增或修改資源回收筒相關配置項。
單擊确定。
資源回收筒相關配置項說明如下。
配置項 | 類型 | 預設值 | 說明 |
| Integer |
| 資料庫、資料表等中繼資料在資源回收筒中的保護天數。必須為大於等於 1 的整數。保護期內允許還原;到期後相關資料和中繼資料進入不可還原的清理階段。 |
| Integer |
| 系統資源回收筒( |
步驟二:進入資源回收筒頁面
登入資料湖構建控制台
在左側導覽列,選擇系统和安全。
在系統和安全頁面,單擊回收站。
根據需要選擇数据库、数据表或文件分類。
步驟三:還原資料庫或資料表
在資源回收筒頁面,選擇数据库或数据表分類。
選擇目標 Catalog,並按需輸入資料庫或資料表名稱進行篩選。
找到需要恢複的資料庫或資料表。
確認狀態為删除保护中。
在操作列,單擊还原。
步驟四:查看回收檔案
在資源回收筒頁面,選擇文件分類。
選擇目標 Catalog,並按需輸入檔案名稱或路徑關鍵字進行篩選。
查看被刪除的檔案資訊。
檔案分類展示的是系統資源回收筒(system.trash)中的孤兒檔案,僅支援查看,不支援還原。
注意事項
保留期獨立: 中繼資料保護期(
dlf.trashed-meta-retained-days)和檔案保留期(dlf.trashed-file-retained-days)是兩個獨立的配置項。前者控制資料庫、表等中繼資料及資料可還原的時間;後者控制系統資源回收筒中孤兒檔案的保留時間。還原聯動: 還原資料庫時,隨資料庫一起進入資源回收筒的庫內資料表會一併恢複。此前單獨刪除的資料表需在資料表分類中單獨還原。
後台清理: 刪除資料庫或表後,相關資料和中繼資料會先進入資源回收筒。永久刪除由後台清理任務完成,具體完成時間取決於配置的保護期和後台清理調度。