ALTER TABLE OPTIONS

引入或更新: v1.2.643

为表设置或取消Fuse Engine选项。

语法

-- 设置Fuse Engine选项
ALTER TABLE [ <database_name>. ]<table_name> SET OPTIONS (<options>)

-- 取消Fuse Engine选项，恢复为默认值
ALTER TABLE [ <database_name>. ]<table_name> UNSET OPTIONS (<options>)

请注意，只有以下Fuse Engine选项可以被取消：

• block_per_segment
• block_size_threshold
• data_retention_period_in_hours
• row_avg_depth_threshold
• row_per_block
• row_per_page

示例

以下演示如何设置Fuse Engine选项并通过SHOW CREATE TABLE验证更改：

CREATE TABLE fuse_table (a int);

SET hide_options_in_show_create_table=0;

-- 显示当前的CREATE TABLE语句，包括Fuse Engine选项
SHOW CREATE TABLE fuse_table;

-[ RECORD 1 ]-----------------------------------
       Table: fuse_table
Create Table: CREATE TABLE fuse_table (
  a INT NULL
) ENGINE=FUSE COMPRESSION='lz4' STORAGE_FORMAT='native'

-- 将段中的最大块数更改为500
-- 将数据保留期更改为240小时
ALTER TABLE fuse_table SET OPTIONS (block_per_segment = 500, data_retention_period_in_hours = 240);

-- 显示更新后的CREATE TABLE语句，反映新的选项
SHOW CREATE TABLE fuse_table;

-[ RECORD 1 ]-----------------------------------
       Table: fuse_table
Create Table: CREATE TABLE fuse_table (
  a INT NULL
) ENGINE=FUSE BLOCK_PER_SEGMENT='500' COMPRESSION='lz4' DATA_RETENTION_PERIOD_IN_HOURS='240' STORAGE_FORMAT='native'

以下演示如何取消Fuse Engine选项，恢复为默认值：

ALTER TABLE fuse_table UNSET OPTIONS (block_per_segment, data_retention_period_in_hours);

SHOW CREATE TABLE fuse_table;

-[ RECORD 1 ]-----------------------------------
       Table: fuse_table
Create Table: CREATE TABLE fuse_table (
  a INT NULL
) ENGINE=FUSE COMPRESSION='lz4' STORAGE_FORMAT='native'