ALTER DYNAMIC TABLE_实时数仓 Hologres(Hologres)-阿里云帮助中心

Dynamic Table支持修改部分属性。本文为您介绍Alter Dynamic Table用法。

修改刷新任务

暂停刷新任务

设置暂停后，此表后续所有的刷新任务都会停止运行。

-- auto_refresh_enable：是否开启自动刷新。false：暂停不开启。
ALTER [DYNAMIC] TABLE [IF EXISTS] [<schema_name>.]<table_name> SET (auto_refresh_enable = false);

重新启动刷新任务

对于已暂停的表刷新任务，支持重新启动。启动后，将沿用原有的表刷新设置，重新执行刷新任务。

-- auto_refresh_enable：是否开启自动刷新。true：开启。
ALTER [DYNAMIC] TABLE [IF EXISTS] [<schema_name>.]<table_name> SET (auto_refresh_enable = true);

修改刷新模式

当前仅支持增量刷新修改为全量刷新。

说明

修改为全量刷新模式后，会将原有的增量刷新任务停止。请根据业务需要，重新设置刷新开始时间和刷新间隔。
系统会自动将增量刷新的状态表清理掉，减少存储占用。

--修改刷新模式refresh_mode，只能增量（incremental）刷新改为全量（full）刷新。
ALTER [DYNAMIC] TABLE <schema_name>.<table_name> SET (refresh_mode = 'full');

修改刷新开始时间

修改刷新的开始时间，只能修改为一个未来的指定时间。

--修改刷新的开始时间full_auto_refresh_schd_start_time。
ALTER [DYNAMIC] TABLE [IF EXISTS] [<schema>.]<table_name> SET (<incremental/full>_auto_refresh_schd_start_time = '<timestamptz>');

修改刷新时间间隔

支持修改Dynamic Table的刷新时间间隔。修改后的刷新任务将会使用新设置的刷新间隔执行。

--修改刷新的时间间隔full_auto_refresh_interval，如三分钟为'3 minutes'。
ALTER [DYNAMIC] TABLE [IF EXISTS] [<schema>.]<table_name> SET (<incremental/full>_auto_refresh_interval = '[<num> { minutes | hours}]');

修改刷新计算资源和规格

支持修改刷新的计算资源，可以选择本实例资源（local）或者Serverless资源（serverles）。如果是Serverles资源，支持修改计算规格。可以根据业务情况适当的调大/调小刷新的规格，但实例能使用的规格有一定的限制，详情请参见Serverles Computing使用指南。

--修改单个表的refresh资源
ALTER [DYNAMIC] TABLE [ IF EXISTS ] [<schema>.]<table_name> 
SET <incremental/full>_guc_hg_computing_resource ='[local|serverless]'

--如果是serverless模式，还可以修改serverless的计算规格
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema>.]<table_name> 
SET <incremental/full>_guc_hg_experimental_serverless_computing_required_cores='<num>'

修改Query定义

Dynamic Table支持修改Query定义。

说明

修改Query定义后，只会修改表的Query定义，并不会修改原来的字段名、字段属性等。
请谨慎执行修改Query定义，如果新query的字段跟原字段不一致，可能会导致refresh报错，或者可能会出现数据不一致等问题。

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

修改Dynamic Table表属性

Dynamic Table支持修改表属性，但仅支持修改如下属性，其余未列出的暂不支持修改。详情请参见ALTER TABLE。

--重命表名
ALTER TABLE [IF EXISTS] <name> RENAME TO <new_name>;

--修改定义
ALTER [DYNAMIC] TABLE [IF EXISTS] <name> SET TASK_DEFINITION = 'select xxx';

--修改dictionary
ALTER [DYNAMIC] TABLE [<schema_name>].<table_name> SET (dictionary_encoding_columns = '[columnName{:[on|off|auto]}[,...]]'); 

--修改bitmap
ALTER [DYNAMIC] TABLE [<schema_name>].<table_name> SET (bitmap_columns = '[columnName{:[on|off]}[,...]]');

--修改TTL
ALTER [DYNAMIC] TABLE [<schema_name>].<table_name> SET (time_to_live_in_seconds = 'num');

--修改schema
ALTER [DYNAMIC] TABLE [IF EXISTS] [<schema>.]<table_name> SET SCHEMA <new_schema>;