表回收站

示例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;