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 とクラスタリングキーを含む) を回復します。
   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; 

• 同じ名前の新しいテーブルが、削除されたテーブルと同じ PK とクラスタリングキーを持っている場合、名前を変更しても競合は解決されません。元のテーブルを回復するには、新しいテーブルを別のスキーマに移動するか、削除する必要があります。

  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;
     
     -- 既存のテーブルには PK とクラスタリングキーがあるため、回復は依然として失敗します。
     RECOVER  TABLE tbl1;

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

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

  4. tbl1 テーブルを別のスキーマに移動してから回復します。これで回復は成功します。

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