Hologres：表資源回收筒

樣本1：刪除普通表並恢複

1. 準備一張普通表，並執行刪除操作。

   CREATE TABLE tbl1 (
     id INT NOT NULL)
   WITH (
       orientation = 'column',
       distribution_key = 'id',
       clustering_key = 'id',
       event_time_column = 'id');
   INSERT INTO tbl1 SELECT i  FROM GENERATE_SERIES(1, 1000000) i;
   DROP TABLE tbl1;

2. 查看資源回收筒，確認表已經進入資源回收筒。

   SELECT * FROM hologres.hg_recyclebin;

   返回結果如下：

   table_id | schema_name | table_name |   table_owner   |    dropby   |   drop_time        
   ---------+-------------+------------+-----------------+-------------+-----------------------
          14| public      | tbl1       | xx_developer  | 1365xxxxxxxx| 2025-04-17 19:23:10+08
   (1 row)

   查看錶的儲存：

   SELECT (hologres.hg_recyclebin_relation_size('tbl1')/1024)::text||'KB' AS hg_recyclebin_relation_size;

   表格儲存體結果如下：

   hg_recyclebin_relation_size 
   -----------------------------
                         1336KB
   (1 row)

3. 恢複表。

   --恢複普通表tbl1的所有資料和屬性（包括pk、clustering key等）
   RECOVER TABLE tbl1;  

樣本2：刪除分區表並恢複

1. 準備一張分區表，對應的父表和子表如下：

   CREATE TABLE tbl2_parent(id INT) PARTITION BY list (id);
   CREATE TABLE tbl2_child_1 PARTITION OF tbl2_parent FOR VALUES IN (1);
   CREATE TABLE tbl2_child_2 PARTITION OF tbl2_parent FOR VALUES IN (2);

2. 刪除其中一張子表並恢複，恢複後的子表是一張普通表，需要手動Attach到原來的分區父表上。

   --刪除一張分區子表
   DROP TABLE tbl2_child_1;
   
   --分區子表進入資源回收筒
   SELECT * FROM hologres.hg_recyclebin;

   返回結果如下：

   table_id | schema_name |  table_name  |   table_owner    |   dropby  |       drop_time        
   ----------+-------------+--------------+------------------+-----------+------------------------
          16 | public      | tbl2_child_1 | xx_developer   | 1365xxxxx | 2025-04-17 19:33:30+08
   (1 row)

   恢複該分區子表，並查看該表的結構為一張普通表，不再是一張分區子表。

   RECOVER TABLE tbl2_child_1;  
   SELECT hg_dump_script('tbl2_child_1');

   返回結果如下：

    hg_dump_script                        
   --------------------------------------------------------------
    BEGIN;                                                      +
                                                                +
    /*                                                          +
    DROP TABLE public.tbl2_child_1;                             +
    */                                                          +                   
    CREATE TABLE public.tbl2_child_1 (                          +
        id INTEGER                                              +
    ) WITH (                                                    +
    orientation = 'column',                                     +
    storage_format = 'orc',                                     +
    table_group = 'xxxx_tg_default',                            +
    table_storage_mode = 'any',                                 +
    time_to_live_in_seconds = '3153600000'                      +
    );                                                          +
                                                                +
                                                                +
                                                                +
    COMMENT ON TABLE public.tbl2_child_1 IS NULL;               +
    ALTER TABLE public.tbl2_child_1 OWNER TO "xx_developer";    +
                                                                +
                                                                +
    END;                                                        +
    
   (1 row)

3. 刪除分區父表，恢複後，仍然是分區表。

   --刪除分區父表
   DROP TABLE tbl2_parent CASCADE;
   
   --查看資源回收筒，父表以及子表都進入資源回收筒
   SELECT * FROM hologres.hg_recyclebin;                   

   返回結果如下：

   table_id | schema_name |  table_name  |   table_owner |      dropby   |       drop_time        
   ---------+-------------+--------------+---------------+---------------+------------------------
         17 | public      | tbl2_child_2 | xx_developer | 1365xxxxxxxx | 2025-04-17 19:41:04+08
         15 | public      | tbl2_parent  | xx_developer | 1365xxxxxxxx | 2025-04-17 19:41:04+08

   恢複分區父表。

   RECOVER TABLE tbl2_parent; 

   在PSQL用戶端中執行如下語句查看分區父表DDL。

   \d+ tbl2_parent;

   返回結果如下，其子表也一併被恢複。

                             Partitioned table "public.tbl2_parent"
    Column |  Type   | Collation | Nullable | Default | Storage | Stats target | Description
   --------+---------+-----------+----------+---------+---------+--------------+-------------
    id     | integer |           |          |         | plain   |              |
   Partition key: LIST (id)
   Partitions: tbl2_child_2 FOR VALUES IN (2)

樣本4：恢複重名表

• 如果表刪除後，在DB中建立了一個重名表，此時恢複已刪除的表會報錯，需要重新命名已有表。

  1. 建立表tbl6，並執行刪除。

     CREATE TABLE tbl6(id INT);
     --刪除表，並進入資源回收筒
     DROP TABLE tbl6;

  2. 重新建立一個重名表tbl6，並恢複已刪除的表tbl6。

     CREATE TABLE tbl6(id INT);
     RECOVER TABLE tbl6;   

     返回結果如下，恢複失敗，因為存在重名表，需要刪除或RENAME重名表。

     ERROR:  Table public.tbl6 already exists

  3. 將已有表tbl6重新命名為tbl6_rename後，再次恢複已刪除的表tbl6，即可執行成功。

     ALTER TABLE tbl6 rename to tbl6_rename;
     RECOVER TABLE tbl6; 

• 如果已有的重名表，設定了跟刪除的表相同的PK、Clustering key，無法重名表來恢複刪除的表。需要將已有的重名表移動Schema或者刪除才能恢複。

  1. 建立表tbl1，並執行刪除。

     --建立一張表並設定pk和clustering key
     CREATE TABLE tbl1 (
         col1 INT,
         col2 INT,
         col3 INT,
         PRIMARY KEY (col1, col2)
     )
     WITH (
         clustering_key = 'col1'
     );
     --刪除這張表
     DROP TABLE  tbl1;
     
     --重新建立一張重名表，並設定pk和clustering key
     CREATE TABLE tbl1 (
         col1 INT,
         col2 INT,
         col3 INT,
         PRIMARY KEY (col1, col2)
     )
     WITH (
         clustering_key = 'col1'
     );
     
     --查看資源回收筒
     SELECT * FROM  hologres.hg_recyclebin;

     返回結果如下。

     table_id | schema_name | table_name |   table_owner    |      dropby      |       drop_time        
     ----------+-------------+------------+------------------+------------------+------------------------
            493497 | public      | tbl1         | 13659371xxx| 13659371xxx | 2025-04-17 20:11:08+08

  2. 在資源回收筒直接恢複tbl1表將報錯。

     --在資源回收筒恢複刪除的表，報錯，無法恢複
     RECOVER  TABLE tbl1;

     報錯資訊如下。

     ERROR: Table public.tbl1 already exists

  3. 重新命名tbl1表再恢複將報錯。

     --重新命名已有表
     ALTER TABLE tbl1 RENAME TO tbl2;
     
     --恢複仍然報錯，因為已有表存在pk和clustering key
     RECOVER  TABLE tbl1;

     報錯資訊如下。

     ERROR: relation "tbl1_pkey" already EXISTS IN SCHEMA "public" 

  4. 將tbl1表移動到其他Schema下，再進行恢複，才可恢複成功。

     CREATE SCHEMA test;
     ALTER TABLE tbl2 SET SCHEMA test;
     
     --可以成功recover
     RECOVER  TABLE tbl1;