Hologres：ALTER DYNAMIC TABLE

V4.0.7 and later

-- Memodifikasi sumber daya komputasi untuk refresh. Anda dapat memilih eksekusi lokal atau eksekusi serverless.
ALTER [DYNAMIC] TABLE [ IF EXISTS ] [<schema>.]<table_name> SET (['local' | 'serverless' | '<warehouse_name>'])

-- Memodifikasi spesifikasi komputasi untuk eksekusi serverless.
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema>.]<table_name> SET (auto_refresh_guc_hg_experimental_serverless_computing_required_cores='<num>')

V3.1

-- Memodifikasi sumber daya komputasi untuk refresh. Anda dapat memilih eksekusi lokal atau eksekusi serverless.
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (computing_resource ='[local|serverless]');

-- Memodifikasi spesifikasi komputasi untuk eksekusi serverless.
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (refresh_guc_hg_experimental_serverless_computing_required_cores='<num>');

V3.0

-- Memodifikasi sumber daya refresh untuk satu tabel.
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (<incremental/full>_guc_hg_computing_resource ='[local|serverless]');

-- Jika dalam mode serverless, Anda juga dapat memodifikasi spesifikasi komputasi serverless.
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (<incremental/full>_guc_hg_experimental_serverless_computing_required_cores='<num>');

V3.1 syntax

ALTER DYNAMIC TABLE <schema_name>.<table_name> SET (auto_refresh_mode = '<full/auto>');

Sintaks V3.0

ALTER DYNAMIC TABLE <schema_name>.<table_name> SET (refresh_mode = 'full');

V3.1 syntax

Mulai dari Hologres V3.1.18, Anda dapat memodifikasi definisi kueri tabel dinamis dan menambahkan kolom ke tabel dinamis dengan menambahkan kolom dalam kueri.

ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
AS
<query>; -- Definisi kueri baru.

• Catatan penggunaan:

  • Definisi kueri baru harus memenuhi persyaratan berikut:

    • Skema tabel yang dihasilkan oleh kueri baru harus kompatibel dengan skema tabel yang dihasilkan oleh kueri asli. Persyaratan ini mencakup hal-hal berikut:

      • Kedua tabel harus merupakan tabel partisi atau tabel non-partisi.

      • Primary key (PK) kedua tabel harus sama.

      • Kunci distribusi kedua tabel harus sama. Anda tidak dapat memodifikasi kunci distribusi.

      • Kunci partisi kedua tabel harus sama. Anda tidak dapat memodifikasi kunci partisi.

      • Kunci pengelompokan (clustering key), kunci segmen (segment key), mode penyimpanan (misalnya column store atau row-column hybrid store), dictionary encoding, dan indeks bitmap kedua tabel harus sama.

      • Nama bidang kedua tabel harus sama. Anda tidak dapat memodifikasi nama bidang.

      • Bidang dengan nama yang sama harus memiliki tipe data dan properti NULLABLE yang sama.

    • Anda hanya dapat menambahkan kolom dalam kueri. Anda tidak dapat menghapus kolom. Saat menambahkan kolom, data yang sudah ada tetap tidak berubah. Kolom baru diisi dengan nilai NULL secara default dan akan diperbarui setelah refresh berikutnya.

  • Setelah memodifikasi definisi kueri, perilaku pembaruan adalah sebagai berikut:

    • Tabel dinamis non-partisi: Pembaruan berikutnya, baik otomatis maupun manual, akan memicu Refresh Overwrite.

    • Tabel dinamis dengan partisi logis: Partisi aktif secara otomatis memicu Refresh Overwrite selama auto-refresh berikutnya. Partisi historis memerlukan refresh manual.

    Setelah memodifikasi definisi kueri, jika kueri berisi operator yang tidak didukung oleh pembaruan bertahap, perilaku pembaruan adalah sebagai berikut:

    Mode Pembaruan	Definisi Kueri Baru Mendukung Pembaruan Bertahap	Definisi Kueri Baru Tidak Mendukung Pembaruan Bertahap
    auto_refresh_mode = 'auto'	refresh_mode yang ditentukan saat pembuatan tabel tetap dipertahankan.	refresh_mode secara otomatis berubah menjadi full refresh.
    auto_refresh_mode = 'incremental'	Incremental refresh tetap dipertahankan.	Pembaruan gagal. Anda harus secara manual mengubah mode menjadi pembaruan penuh.
    auto_refresh_mode = 'full'	Full refresh tetap dipertahankan.	Full refresh tetap dipertahankan.

• Contoh

  1. Siapkan data sampel.

     -- Siapkan tabel sumber.
     CREATE TABLE employees (
         department_id INT,
         employee_name VARCHAR
     );
     -- Masukkan data.
     INSERT INTO employees (department_id, employee_name) VALUES
     (1, 'John'),
     (1, 'Jane'),
     (1, 'John'),  -- Nilai duplikat
     (2, 'Alice'),
     (2, 'Bob'),
     (2, 'Alice'); -- Nilai duplikat
     
     -- Buat tabel dinamis.
     CREATE  DYNAMIC TABLE dt_employees
     WITH (
       -- Properti tabel dinamis
       freshness = '1 minutes', 
       auto_refresh_mode = 'auto',
       distribution_key = 'department_id'
     )
     AS 
     SELECT
         department_id
     FROM employees   
     GROUP BY department_id;
     
     -- Kueri data di tabel dinamis.
     SELECT * FROM dt_employees;

  2. Tambahkan kolom ke tabel dinamis.

     -- Tambahkan kolom.
     ALTER DYNAMIC TABLE dt_employees
     AS 
     SELECT
         department_id,
        STRING_AGG(DISTINCT employee_name, ', ') AS unique_employees
     FROM employees   
     GROUP BY department_id;
     

     Setelah pernyataan berhasil dieksekusi, Anda dapat mengkueri data di tabel dinamis. Data di kolom baru bernilai NULL.

     department_id	｜unique_employees
     -----------｜--------
     1	｜\N
     2	｜\N

     Setelah refresh berikutnya berhasil, data di kolom baru diperbarui.

     department_id	｜unique_employees
     -------------｜---------
     1	｜Jane, John
     2 ｜	Bob, Alice

Sintaks V3.0

Hologres V3.0 mendukung modifikasi definisi kueri. Sintaksnya adalah sebagai berikut. Saat ini, hanya modifikasi dalam mode full refresh yang didukung. Modifikasi dalam mode incremental refresh tidak didukung.

ALTER DYNAMIC TABLE [IF EXISTS] [<schema>.]<table_name> SET (task_definition = $$<new_query>$$);