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 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');

-- NOT NULL 列を追加し、デフォルト値を設定します。
ASYNC REBUILD TABLE rebuild_test ADD COLUMN c text NOT NULL DEFAULT 'a';

-- プライマリキーを列 a に変更します。
ASYNC REBUILD TABLE rebuild_test ALTER PRIMARY KEY (a);

-- Serverless リソースを使用して Rebuild タスクを実行します。
-- テーブルの distribution_key と clustering_key を設定し、orientation を行列ハイブリッドストアに変更します。
ASYNC REBUILD TABLE rebuild_test 
WITH (
    rebuild_guc_hg_computing_resource = 'serverless'
)
SET (
    distribution_key = 'a',
    clustering_key = 'a',
    orientation = 'row,column'
);

-- 標準テーブルを論理パーティションテーブルに変換します。
-- パーティションキーを ds に設定し、ds 列に NOT NULL 制約を追加します。
ASYNC REBUILD TABLE rebuild_test 
    ALTER COLUMN ds SET NOT NULL,
    TO LOGICAL PARTITION BY LIST(ds);

バイナリロギングが有効なテーブルでの REBUILD の実行

REBUILD コマンドは、履歴バイナリロギング (Binlog) データを保持しません。そのため、デフォルトでバイナリロギングが有効になっているテーブルで REBUILD を実行することはできません。この操作を実行するには、REBUILD タスクで binlog_mode パラメーターを設定し、以下の手順に従う必要があります。このプロセスにより、テーブルが再構築される前に、ダウンストリームクライアントがすべての履歴 Binlog データを消費したことが保証されます。

1. REBUILD を実行します。

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

2. binlog_mode パラメーターを含む REBUILD タスクの場合、set_readonly ステップが完了するとタスクは自動的に一時停止します。次の SQL コマンドを実行して進行状況を確認できます。この時点で、システムはテーブルを読み取り専用に設定しています。テーブルにデータを書き込むことはできず、新しい Binlog データは生成されません。

   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. ダウンストリームクライアントが既存の Binlog データの消費を完了するのを待ちます。その後、手動で次の SQL コマンドを実行して REBUILD タスクを再開します。このプロセス中、ソーステーブルは読み取り専用のままであり、新しい Binlog データは生成されません。

   RESUME '<query_id>';

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

REBUILD タスクのステータスの確認

REBUILD タスクは非同期で実行されます。タスクを送信すると、システムは送信の成功ステータスと query_id を返します。hologres.rebuild_progress システムテーブルで非同期サブタスクのステータスを確認する必要があります。REBUILD 操作は、すべてのサブタスクが成功した後にのみ完了します。次のコマンドを使用してステータスを確認できます：

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>');

• ソーステーブルが読み取り専用に設定された後にタスクが中断された場合は、次のコマンドを使用してテーブルへの書き込み操作を復元します。

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