Hologres：Keranjang daur ulang tabel

Contoh 1: Menghapus dan memulihkan tabel standar

1. Buat tabel standar lalu 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 keranjang daur ulang untuk memastikan tabel tersebut ada di dalamnya.

   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)

   Anda dapat melihat penyimpanan tabel tersebut:

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

   Hasil berikut menunjukkan penyimpanan tabel:

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

3. Pulihkan tabel.

   -- Memulihkan semua data dan properti tabel standar tbl1, termasuk PK dan clustering key.
   RECOVER TABLE tbl1;  

Contoh 2: Hapus dan pulihkan tabel partisi

1. Buat tabel partisi dengan tabel induk dan partisi anak berikut:

   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 dan pulihkan salah satu partisi anak. Partisi anak yang dipulihkan menjadi tabel standar. Anda harus secara manual melampirkannya ke tabel induk asli.

   -- Menghapus partisi anak.
   DROP TABLE tbl2_child_1;
   
   -- Partisi anak dipindahkan ke keranjang daur ulang.
   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 partisi anak dan periksa strukturnya. Partisi dipulihkan sebagai tabel standar, bukan partisi 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.

   -- Menghapus tabel induk.
   DROP TABLE tbl2_parent CASCADE;
   
   -- Periksa keranjang daur ulang. Baik tabel induk maupun partisi anak dipindahkan ke keranjang daur ulang.
   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; 

   Anda dapat menjalankan pernyataan berikut di Klien PSQL untuk melihat DDL tabel induk tersebut.

   \d+ tbl2_parent;

   Hasil berikut menunjukkan bahwa partisi anak 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)

Contoh 4: Memulihkan tabel dengan nama yang bertentangan

• Jika Anda menghapus tabel lalu membuat tabel baru dengan nama yang sama di DB, kesalahan akan dilaporkan saat Anda mencoba memulihkan tabel yang dihapus. Anda harus mengganti nama tabel yang ada.

  1. Buat dan hapus tabel tbl6.

     CREATE TABLE tbl6(id INT);
     -- Menghapus tabel. Tabel dipindahkan ke keranjang daur ulang.
     DROP TABLE tbl6;

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

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

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

     ERROR:  Table public.tbl6 already exists

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

     ALTER TABLE tbl6 rename to tbl6_rename;
     RECOVER TABLE tbl6; 

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

  1. Buat dan hapus tabel tbl1.

     -- Buat tabel dan atur primary key serta clustering key.
     CREATE TABLE tbl1 (
         col1 INT,
         col2 INT,
         col3 INT,
         PRIMARY KEY (col1, col2)
     )
     WITH (
         clustering_key = 'col1'
     );
     -- Menghapus tabel.
     DROP TABLE  tbl1;
     
     -- Buat tabel baru dengan nama yang sama dan atur primary key serta clustering key.
     CREATE TABLE tbl1 (
         col1 INT,
         col2 INT,
         col3 INT,
         PRIMARY KEY (col1, col2)
     )
     WITH (
         clustering_key = 'col1'
     );
     
     -- Periksa keranjang daur ulang.
     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. Kesalahan dilaporkan jika Anda mencoba langsung memulihkan tabel tbl1 dari keranjang daur ulang.

     -- Memulihkan tabel yang dihapus dari keranjang daur ulang. Kesalahan dilaporkan dan pemulihan gagal.
     RECOVER  TABLE tbl1;

     Pesan kesalahan berikut dikembalikan.

     ERROR: Tabel public.tbl1 sudah ada

  3. Kesalahan dilaporkan jika Anda mengganti nama tabel tbl1 lalu mencoba memulihkan tabel yang dihapus.

     -- 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 kesalahan berikut dikembalikan.

     ERROR: relasi "tbl1_pkey" sudah ADA DI SKEMA "public" 

  4. Pindahkan tabel tbl1 ke skema lain lalu pulihkan. Pemulihan berhasil.

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