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 のすべてのデータとプロパティ (プライマリキーとクラスタリングキーを含む) を復元します。
   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. 子テーブルの1つを削除して復元します。復元された子テーブルは標準テーブルになり、元の親テーブルに手動でアタッチする必要があります。

   -- 子テーブルを削除します。
   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： 名前が競合するテーブルの復元

• テーブルを削除した後に同じ名前の新しいテーブルを作成した場合、削除したテーブルの復元は失敗します。まず既存のテーブルの名前を変更する必要があります。

  1. tbl6 を作成して削除します。

     CREATE TABLE tbl6(id INT);
     -- テーブルを削除し、ごみ箱に移動します。
     DROP TABLE tbl6;

  2. 同じく tbl6 という名前の新しいテーブルを作成し、削除されたテーブルの復元を試みます。

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

     次の結果が返されます。同じ名前のテーブルが既に存在するため、復元は失敗します。既存のテーブルを削除または名前変更する必要があります。

     ERROR:  Table public.tbl6 already exists

  3. 既存のテーブル tbl6 の名前を tbl6_rename に変更し、元の tbl6 を復元します。これで復元は成功します。

     ALTER TABLE tbl6 RENAME TO tbl6_rename;
     RECOVER TABLE tbl6; 

• 同じ名前の既存のテーブルが、削除されたテーブルと同じプライマリキーとクラスタリングキーを持っている場合、名前を変更するだけでは復元できません。削除されたテーブルを復元する前に、既存のテーブルを別のスキーマに移動するか、削除する必要があります。

  1. tbl1 という名前のテーブルを作成して削除します。

     -- テーブルを作成し、PK とクラスタリングキーを設定します。
     CREATE TABLE tbl1 (
         col1 INT,
         col2 INT,
         col3 INT,
         PRIMARY KEY (col1, col2)
     )
     WITH (
         clustering_key = 'col1'
     );
     -- テーブルを削除します。
     DROP TABLE  tbl1;
     
     -- 同じ名前、PK、クラスタリングキーを持つ新しいテーブルを作成します。
     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;
     
     -- 既存のテーブルにはプライマリキーとクラスタリングキーがあるため、復元はまだ失敗します。
     RECOVER  TABLE tbl1;

     次のエラーメッセージが返されます。

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

  4. 新しいテーブルを別のスキーマに移動します。その後、元のテーブルを正常に復元できます。

     CREATE SCHEMA test;
     ALTER TABLE tbl2 SET SCHEMA test;
     
     -- 復元は成功しました。
     RECOVER  TABLE tbl1;