Hologres:Table recycle bin

Example 1: Delete and recover a table

1. Buat tabel standar dan hapus.

   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. Periksa recycle bin untuk memastikan tabel telah dipindahkan ke sana.

   SELECT * FROM hologres.hg_recyclebin;

   Hasil berikut dikembalikan:

   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)

   Periksa penyimpanan tabel:

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

   Perintah mengembalikan ukuran penyimpanan tabel:

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

3. Pulihkan tabel.

   -- Pulihkan semua data dan properti tabel standar tbl1, termasuk primary key dan clustering key-nya.
   RECOVER TABLE tbl1;  

Example 2: Delete and recover a partitioned table

1. Buat tabel partisi beserta tabel induk dan tabel anak yang sesuai.

   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. Hapus salah satu tabel anak dan pulihkan. Tabel anak yang dipulihkan menjadi tabel standar dan harus dilampirkan secara manual ke tabel induk aslinya.

   -- Hapus tabel anak.
   DROP TABLE tbl2_child_1;
   
   -- Tabel anak dipindahkan ke recycle bin.
   SELECT * FROM hologres.hg_recyclebin;

   Hasil berikut dikembalikan:

   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)

   Pulihkan tabel anak dan periksa strukturnya. Sekarang ini menjadi tabel standar dan bukan lagi tabel anak.

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

   Hasil berikut dikembalikan:

    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. Hapus tabel induk. Setelah dipulihkan, tabel tersebut tetap menjadi tabel partisi.

   -- Hapus tabel induk.
   DROP TABLE tbl2_parent CASCADE;
   
   -- Periksa recycle bin. Tabel induk dan tabel anak keduanya dipindahkan ke recycle bin.
   SELECT * FROM hologres.hg_recyclebin;                   

   Hasil berikut dikembalikan:

   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

   Pulihkan tabel induk.

   RECOVER TABLE tbl2_parent; 

   Jalankan pernyataan berikut di psql client untuk melihat DDL tabel induk.

   \d+ tbl2_parent;

   Hasil berikut dikembalikan, yang menunjukkan bahwa tabel anaknya juga dipulihkan.

                             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)

Example 4: Recover a table with a conflicting name

• Jika Anda menghapus tabel lalu membuat tabel baru dengan nama yang sama, pemulihan tabel yang dihapus akan gagal. Anda harus mengganti nama tabel yang ada terlebih dahulu.

  1. Buat dan hapus tbl6.

     CREATE TABLE tbl6(id INT);
     -- Hapus tabel dan pindahkan ke recycle bin.
     DROP TABLE tbl6;

  2. Buat tabel baru yang juga bernama tbl6 dan coba pulihkan tabel yang dihapus.

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

     Hasil berikut dikembalikan. Pemulihan gagal karena sudah ada tabel dengan nama yang sama. Anda harus menghapus atau mengganti nama tabel yang ada.

     ERROR:  Table public.tbl6 already exists

  3. Ganti nama tabel yang ada tbl6 menjadi tbl6_rename, lalu pulihkan tbl6 asli. Pemulihan sekarang berhasil.

     ALTER TABLE tbl6 RENAME TO tbl6_rename;
     RECOVER TABLE tbl6; 

• Jika tabel yang ada dengan nama yang sama memiliki primary key dan clustering key yang sama dengan tabel yang dihapus, mengganti namanya tidak akan berhasil. Anda harus memindahkan tabel yang ada ke skema lain atau menghapusnya sebelum memulihkan tabel yang dihapus.

  1. Buat tabel bernama tbl1 dan hapus.

     -- Buat tabel dan atur PK serta clustering key.
     CREATE TABLE tbl1 (
         col1 INT,
         col2 INT,
         col3 INT,
         PRIMARY KEY (col1, col2)
     )
     WITH (
         clustering_key = 'col1'
     );
     -- Hapus tabel.
     DROP TABLE  tbl1;
     
     -- Buat tabel baru dengan nama, PK, dan clustering key yang sama.
     CREATE TABLE tbl1 (
         col1 INT,
         col2 INT,
         col3 INT,
         PRIMARY KEY (col1, col2)
     )
     WITH (
         clustering_key = 'col1'
     );
     
     -- Periksa recycle bin.
     SELECT * FROM  hologres.hg_recyclebin;

     Hasil berikut dikembalikan.

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

  2. Mencoba memulihkan tabel tbl1 dari recycle bin gagal.

     -- Coba pulihkan tabel yang di-drop dari recycle bin. Pemulihan gagal.
     RECOVER  TABLE tbl1;

     Pesan error berikut dikembalikan.

     ERROR: Table public.tbl1 already exists

  3. Mengganti nama tabel tbl1 lalu mencoba memulihkan tabel asli tetap gagal.

     -- Ganti nama tabel yang ada.
     ALTER TABLE tbl1 RENAME TO tbl2;
     
     -- Pemulihan tetap gagal karena tabel yang ada memiliki primary key dan clustering key.
     RECOVER  TABLE tbl1;

     Pesan error berikut dikembalikan.

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

  4. Pindahkan tabel baru ke skema lain. Kemudian, Anda dapat berhasil memulihkan tabel asli.

     CREATE SCHEMA test;
     ALTER TABLE tbl2 SET SCHEMA test;
     
     -- Pemulihan berhasil.
     RECOVER  TABLE tbl1;