Hologres:REBUILD

コマンド形式

ASYNC REBUILD TABLE [ IF EXISTS ] <table_name>
    [ WITH ( <rebuild_parameter> [= <value>] [, ... ] )]  
    <action> [, ... ];
    
WHERE action IS ONE OF:
    ADD [ COLUMN ] <column_name> <data_type> [ column_constraint [ ... ] ]
    ALTER [ COLUMN ] <column_name> [ SET DATA ] TYPE <data_type> [ USING <expression> ]
    ALTER [ COLUMN ] <column_name> SET DEFAULT <expression>
    ALTER [ COLUMN ] <column_name> DROP DEFAULT
    ALTER [ COLUMN ] <column_name> { SET | DROP } NOT NULL
    ALTER PRIMARY KEY (<column_name> [, ...])
    TO [LOGICAL] PARTITION [BY LIST(<column_name> [, <column_name>])]
    SET ( <parameter> [= <value>] [, ... ] )

WHERE rebuild_parameter IS ONE OF:
    keep_source
    binlog_mode
    rebuild_guc_<guc_name> = '<guc_value>'

パラメーターの説明

バイナリログが無効なテーブルで REBUILD を実行する

-- Create a table and import data
CREATE TABLE rebuild_test (
    a TEXT,
    b TEXT,
    ds TEXT
);

INSERT INTO rebuild_test VALUES ('1', '1', '2025-04-01'), ('2', '2', '2025-04-02'), ('3', '3', '2025-04-03');

-- Add a NOT NULL column and set a default value
ASYNC REBUILD TABLE rebuild_test ADD COLUMN c text NOT NULL DEFAULT 'a';

-- Change the primary key to column a
ASYNC REBUILD TABLE rebuild_test ALTER PRIMARY KEY (a);

-- Use Serverless resources to run the Rebuild task, set the distribution_key and clustering_key for the table, and change the storage format to row-column hybrid
ASYNC REBUILD TABLE rebuild_test 
WITH (
    rebuild_guc_hg_computing_resource = 'serverless'
)
SET (
    distribution_key = 'a',
    clustering_key = 'a',
    orientation = 'row,column'
);

-- Convert the non-partitioned table to a logical partitioned table, set the partition key to ds, and add the NOT NULL property to the ds column
ASYNC REBUILD TABLE rebuild_test 
    ALTER COLUMN ds SET NOT NULL,
    TO LOGICAL PARTITION BY LIST(ds);

バイナリログが有効なテーブルで REBUILD を実行する

REBUILD は過去のバイナリログデータを保持しません。デフォルトでは、バイナリログが有効なテーブルで REBUILD を実行することはできません。タスクを実行するには、binlog_mode パラメーターを指定し、以下の手順に従う必要があります。これにより、ダウンストリームクライアントがすべての過去のバイナリログデータを完全に消費したことが保証されます。

1. REBUILD を実行します。

   ASYNC REBUILD TABLE rebuild_test 
   WITH (
     binlog_mode
   )
   <YOUR_ACTION>;

2. binlog_mode パラメーターが設定された REBUILD タスクの場合、タスクは set_readonly ステップが完了すると自動的に一時停止します。以下の SQL ステートメントを使用して進行状況をクエリできます。この時点で、システムはテーブルを読み取り専用に設定しています。データはテーブルに書き込めず、新しいバイナリログデータは生成されません。

   postgres=# SELECT step, status, progress FROM hologres.rebuild_progress('<query_id>');
                step              | status | progress 
   -------------------------------+--------+----------
    prepare                       | done   | 1/1
    create_tmp_table              | done   | 1/1
    get_src_table_snapshot        | done   | 1/1
    insert                        | done   | 1/1
    set_readonly                  | done   | 1/1
    check_snapshot                |        | 0/1
    re-insert                     |        | -
    check_additional_child_table  |        | -
    create_additional_child_table |        | -
    insert_additional_child_table |        | -
    swap                          |        | 0/1
   (11 rows)

3. ダウンストリームクライアントが既存のバイナリログデータの消費を完了するのを待ちます。その後、以下の SQL ステートメントを手動で実行して REBUILD タスクを再開します。タスクが再開されている間も、ソーステーブルは読み取り専用のままであり、新しいバイナリログデータは生成されません。

   RESUME '<query_id>';

   REBUILD タスクが正常に実行されると、新しいテーブルに対してバイナリログが自動的に有効になります。その後、ダウンストリームのバイナリログ消費タスクを再開し、lsn = 0 から新しいテーブルのバイナリログの消費を開始できます。

REBUILD タスクの実行ステータス表示

REBUILD タスクは非同期的に実行されます。タスクが送信されると、システムは成功ステータスと query_id を返します。hologres.rebuild_progress システムテーブルをクエリして、非同期サブタスクのステータスを表示する必要があります。すべてのサブタスクが成功して初めて、テーブルは再構築されたと見なされます。コマンドは以下のとおりです。

SELECT * FROM hologres.rebuild_progress('<rebuild_query_id>');

システムテーブルの列とその説明は以下のとおりです。

以下は結果の例です。

REBUILD タスクの停止と再開

• 非同期 REBUILD タスクを停止します。

  SUSPEND '<query_id>';

• CANCEL によってキャンセルされた非同期タスクを再開します。

  RESUME '<query_id>';

REBUILD タスクの例外処理

REBUILD タスクがエラーによって中断された場合、または SUSPEND コマンドを手動で実行してタスクを一時停止した場合、RESUME コマンドを実行してタスクを続行できます。また、以下の手順に従ってタスクを終了し、ソーステーブルを回復することもできます。

• 以下のコマンドを実行して、REBUILD プロセス中に生成された一時テーブルをクリーンアップします。

  CALL hg_clean_rebuild_tmp_tables('<query_id>');

• タスクが中断される前にソーステーブルが REBUILD タスクによって読み取り専用に設定されていた場合、以下のコマンドを実行して読み取り専用状態を解除し、書き込み操作を再開します。

  ALTER TABLE <table_name> SET (readonly = false);