Hologres：ALTER DYNAMIC TABLE

V4.0.7及以上版本

--修改refresh的計算資源，可以選擇為本地執行或者serverless執行
ALTER [DYNAMIC] TABLE [ IF EXISTS ] [<schema>.]<table_name> SET (['local' | 'serverless' | '<warehouse_name>'])

--修改serverless的計算資源規格
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema>.]<table_name> SET (auto_refresh_guc_hg_experimental_serverless_computing_required_cores='<num>')

V3.1版本

--修改refresh的計算資源，可以選擇為本地執行或者serverless執行
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (computing_resource ='[local|serverless]');

--修改serverless的計算資源規格
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (refresh_guc_hg_experimental_serverless_computing_required_cores='<num>');

V3.0版本

--修改單個表的refresh資源
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (<incremental/full>_guc_hg_computing_resource ='[local|serverless]');

--如果是serverless模式，還可以修改serverless的計算規格
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (<incremental/full>_guc_hg_experimental_serverless_computing_required_cores='<num>');

V3.1版本文法

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

V3.0版本文法

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

V3.1版本文法

Hologres自V3.1.18版本開始，Dynamic Table支援修改Query定義，以及在Query中加列實現給Dynamic Table加列。

ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
AS
<query>; -- 新的query的定義

• 使用說明：

  • 對於新Query定義的要求如下：

    • 新的Query產生的Dynamic Table必須和原Query產生的Dynamic Table表結構相容，包括：

      • 都是分區表或者都是非分區表。

      • 表的PK相同。

      • 表的Distribution Key相同，且不允許修改Distribution Key。

      • 表的Partition Key相同，且不允許修改Partition Key。

      • 表的Clustering Key、Segment Key、表的儲存模式（列存、行列共存等）、Dictionary Encoding、Bitmap Index相同。

      • 欄位名必須相同，且不能修改欄位名。

      • 同名的欄位、資料類型相同，NULLABLE屬性相同。

    • 只能在Query中ADD Column，不支援DROP Column。新增列，已有資料保持不變，新增的列預設補NULL值，會在下一次Refresh後更新資料。

  • 修改Query定義後，Refresh的行為如下：

    • 非分區Dynamic Table：下一次Refresh時（無論是Auto Refresh還是手動Refresh）會支援Refresh Overwrite。

    • 邏輯分區Dynamic Table：活躍分區在下一次Auto Refresh會自動觸發Refresh Overwrite；歷史分區需要手動觸發一次Refresh。

    修改Query定義後，如果Query中有增量重新整理不支援的運算元，此時Refresh的行為如下：

    重新整理模式	新Query定義支援增量重新整理	新Query定義不支援增量重新整理
    auto_refresh_mode = 'auto'	保持建表時指定的refresh_mode。	refresh_mode自動變為全量重新整理。
    auto_refresh_mode = 'incremental'	保持增量重新整理。	重新整理報錯，需要手動改為全量重新整理。
    auto_refresh_mode = 'full'	保持全量重新整理。	保持全量重新整理。

• 使用樣本

  1. 準備樣本資料。

     --準備一張源表
     CREATE TABLE employees (
         department_id INT,
         employee_name VARCHAR
     );
     --插入資料
     INSERT INTO employees (department_id, employee_name) VALUES
     (1, 'John'),
     (1, 'Jane'),
     (1, 'John'),  -- 重複值
     (2, 'Alice'),
     (2, 'Bob'),
     (2, 'Alice'); -- 重複值
     
     --建立一張dynamic table
     CREATE  DYNAMIC TABLE dt_employees
     WITH (
       -- dynamic table的屬性
       freshness = '1 minutes', 
       auto_refresh_mode = 'auto',
       distribution_key = 'department_id'
     )
     AS 
     SELECT
         department_id
     FROM employees   
     GROUP BY department_id;
     
     --查詢dynamic table中的資料
     SELECT * FROM dt_employees;

  2. 對Dynamic Table新增一列。

     --新增一列
     ALTER DYNAMIC TABLE dt_employees
     AS 
     SELECT
         department_id,
        STRING_AGG(DISTINCT employee_name, ', ') AS unique_employees
     FROM employees   
     GROUP BY department_id;
     

     執行成功後查詢Dynamic Table的資料，可以看到新增的資料是NULL。

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

     等到下一次Refresh成功後，可以看到新增的列資料已經重新整理完成。

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

V3.0版本文法

Hologres V3.0支援修改Query定義，文法如下，目前僅支援全量模式修改，增量模式暫不支援。

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