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 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 non-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 resource serverless untuk menjalankan tugas REBUILD, atur distribution_key dan clustering_key untuk tabel, dan ubah penyimpanan menjadi 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 menjadi ds, dan tambahkan kendala NOT NULL pada kolom ds.
ASYNC REBUILD TABLE rebuild_test 
    ALTER COLUMN ds SET NOT NULL,
    TO LOGICAL PARTITION BY LIST(ds);

Rebuild tabel dengan Binlog

REBUILD tidak menyimpan data Binlog historis. Oleh karena itu, REBUILD secara default tidak didukung untuk tabel yang memiliki Binlog aktif. Anda harus menentukan parameter binlog_mode dan mengikuti langkah-langkah berikut untuk memastikan sistem downstream telah sepenuhnya mengonsumsi data Binlog historis.

1. Jalankan perintah REBUILD.

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

2. Jika parameter binlog_mode diatur untuk tugas REBUILD, tugas tersebut akan secara otomatis berhenti sementara setelah langkah set_readonly selesai. Anda dapat menjalankan kueri SQL untuk memeriksa progres. Pada tahap ini, sistem telah mengatur tabel menjadi read-only, sehingga data tidak dapat ditulis ke tabel 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 semua data Binlog yang ada. Kemudian, lanjutkan secara manual tugas REBUILD dengan menjalankan pernyataan SQL berikut. Selama proses ini, tabel sumber tetap dalam mode read-only dan tidak menghasilkan data Binlog baru.

   RESUME '<query_id>';

   Setelah tugas REBUILD selesai, Binlog secara otomatis diaktifkan untuk tabel baru. Anda kemudian dapat memulai ulang tugas konsumsi Binlog downstream dan mulai mengonsumsi dari lsn = 0.

Lihat status eksekusi tugas REBUILD

Tugas REBUILD berjalan secara asinkron. Setelah tugas berhasil dikirim, sistem mengembalikan status sukses dan query_id. Untuk memantau status subtask asinkron, Anda perlu mengkueri tabel sistem hologres.rebuild_progress. Operasi REBUILD untuk tabel tersebut dianggap selesai hanya jika seluruh subtask berhasil. Perintahnya adalah sebagai berikut:

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

Tabel berikut menjelaskan kolom-kolom tabel sistem tersebut.

Gambar berikut menunjukkan contoh hasilnya.

Hentikan dan jalankan ulang tugas REBUILD

• Hentikan tugas asinkron REBUILD.

  SUSPEND '<query_id>';

• Lanjutkan tugas asinkron yang sebelumnya dihentikan dengan status CANCEL.

  RESUME '<query_id>';

Menangani eksepsi tugas REBUILD

Jika tugas REBUILD terganggu oleh error atau Anda menghentikannya secara manual menggunakan perintah SUSPEND, Anda dapat melanjutkannya kembali dengan perintah RESUME atau mengikuti langkah-langkah berikut untuk menghentikan tugas dan memulihkan tabel sumber.

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

  CALL hg_clean_rebuild_tmp_tables('<query_id>');

• Jika tugas terganggu setelah tabel sumber menjadi read-only, jalankan perintah yang sesuai untuk mengaktifkan kembali penulisan.

  • Untuk versi Hologres sebelum V4.1:

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

  • Untuk Hologres V4.1 dan versi setelahnya:

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