Hologres:REBUILD

Format pernyataan

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

Parameter

Rebuild pada tabel tanpa Binlog

-- Buat tabel dan impor 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');
-- Tambahkan kolom NOT NULL dengan nilai default.
ASYNC REBUILD TABLE rebuild_test ADD COLUMN c text NOT NULL DEFAULT 'a';
-- Ubah primary key menjadi kolom a.
ASYNC REBUILD TABLE rebuild_test ALTER PRIMARY KEY (a);
-- Gunakan sumber daya Serverless untuk menjalankan tugas REBUILD, atur distribution_key dan clustering_key, serta ubah ke penyimpanan hibrida baris-kolom.
ASYNC REBUILD TABLE rebuild_test 
WITH (
    rebuild_guc_hg_computing_resource = 'serverless'
)
SET (
    distribution_key = 'a',
    clustering_key = 'a',
    orientation = 'row,column'
);
-- Konversi tabel non-partisi menjadi tabel partisi logis, atur kunci partisi ke ds, dan tambahkan kendala NOT NULL ke kolom ds.
ASYNC REBUILD TABLE rebuild_test 
    ALTER COLUMN ds SET NOT NULL,
    TO LOGICAL PARTITION BY LIST(ds);

Rebuild pada tabel dengan Binlog

Pernyataan REBUILD tidak menyimpan data Binlog historis. Oleh karena itu, secara default Anda tidak dapat menjalankan REBUILD pada tabel yang memiliki Binlog aktif. Anda harus menentukan parameter binlog_mode dan mengikuti langkah-langkah berikut untuk memastikan bahwa konsumen downstream telah sepenuhnya memproses semua data Binlog yang ada.

1. Jalankan pernyataan REBUILD.

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

2. Untuk tugas REBUILD dengan parameter binlog_mode, tugas tersebut secara otomatis berhenti setelah langkah set_readonly selesai. Anda dapat memeriksa progresnya dengan menggunakan pernyataan SQL berikut. Pada titik ini, tabel dalam status read-only, sehingga tidak ada data yang dapat ditulis dan tidak ada data Binlog baru yang dihasilkan.

   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. Tunggu hingga klien downstream selesai mengonsumsi data Binlog yang ada dan hentikan tugas konsumen tersebut. Kemudian, jalankan secara manual pernyataan SQL berikut untuk melanjutkan tugas REBUILD.

   RESUME '<query_id>';

4. Setelah tugas REBUILD selesai, Binlog secara otomatis diaktifkan untuk tabel baru. Anda harus menjalankan ulang tugas konsumsi Binlog downstream secara tanpa status dan mengonsumsi Binlog tabel baru mulai dari lsn = 0.

Konversi tabel reguler menjadi liquid table

Mulai dari Hologres V4.2, Anda dapat menggunakan REBUILD untuk mengonversi tabel reguler menjadi liquid table, atau mengonversi liquid table kembali menjadi tabel reguler.

--- Konversi tabel reguler menjadi liquid table.
ASYNC REBUILD TABLE normal_table 
SET (
  liquid_table = 'true'
);

--- Konversi liquid table menjadi tabel reguler.
ASYNC REBUILD TABLE liquid_table 
SET (
  liquid_table = 'false'
);

Lihat status eksekusi tugas REBUILD

Tugas REBUILD berjalan secara asinkron. Ketika tugas berhasil dikirimkan, pernyataan tersebut mengembalikan status sukses dan query_id. Kueri tampilan sistem hologres.rebuild_progress untuk memantau status subtask asinkron. Operasi REBUILD hanya selesai ketika semua subtask berhasil. Jalankan perintah berikut:

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

Tabel berikut menjelaskan kolom pada tabel sistem tersebut.

Hentikan dan jalankan ulang tugas REBUILD

• Menghentikan sementara tugas asinkron REBUILD.

  SUSPEND '<query_id>';

• Menjalankan ulang tugas asinkron yang ditandai CANCEL.

  RESUME '<query_id>';

Pengecualian tugas bangun ulang

Jika tugas REBUILD terganggu oleh error atau dihentikan secara manual, Anda dapat melanjutkannya dengan perintah RESUME atau menghentikan tugas dan membersihkannya dengan mengikuti langkah-langkah berikut:

• Jalankan perintah berikut untuk membersihkan tabel sementara yang dibuat selama proses REBUILD.

  CALL hg_clean_rebuild_tmp_tables('<query_id>');

• Jika tabel diatur menjadi read-only, jalankan perintah yang sesuai untuk mengembalikan akses tulis.

  • Untuk versi Hologres sebelum V4.1, jalankan perintah berikut.

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

  • Untuk Hologres V4.1 dan versi setelahnya, jalankan perintah berikut.

    ALTER TABLE <table_name> RESET (ddl_options,write_options);