ALTER TABLE语句用于修改表。本文为您介绍ALTER TABLE的用法。

注意事项

Hologres当前对表的修改有如下注意事项:
  • 支持对表进行重命名和增加列的操作。
  • 针对Hologres的分区表,还支持ATTACH PARTITION和DETACH PARTITION两种修改。

重命名

ALTER TABLE语句可以对表进行重命名,如果目标表不存在,或者重命名目标表为已存在的表名称,系统均会返回异常。
  • 使用语法
    --内部表重命名
    ALTER TABLE <table_name> RENAME TO <new_table_name>;
    --外部表重命名
    ALTER FOREIGN TABLE <foreign_table_name> TO <new_foreign_table_name>;
  • 使用示例
    --将表holo_test重命名为holo_test_1
    ALTER TABLE holo_test RENAME TO holo_test_1 ;
    --将外部表foreign_holo_test重命名为foreign_holo_test_1
    ALTER FOREIGN TABLE foreign_holo_test RENAME TO foreign_holo_test_1;

增加列

ALTER TABLE语句可以给表增加列。

  • 使用语法
    --新增一列
    ALTER TABLE IF EXISTS <table_name> ADD COLUMN <new_column> <data_type>;
    --新增多列
    ALTER TABLE IF EXISTS <table_name> ADD COLUMN <new_column_1> <data_type>, ADD COLUMN <new_column_2> <data_type>; 
  • 使用示例
    --在表holo_test中增加id列
    ALTER TABLE IF EXISTS holo_test ADD COLUMN id int;

修改默认值

ALTER TABLE语句支持修改默认值,当前仅Hologres V0.9.23及以上版本支持修改默认值。具体修改方式说明如下:

  • 使用语法
    --修改表字段的默认值
    ALTER TABLE <table> ALTER COLUMN <column> SET DEFAULT <expression>;
    --删除表字段的默认值
    ALTER TABLE <table> ALTER COLUMN <column> DROP DEFAULT;
  • 使用示例
    --修改表holo_test中id列的默认值为0
    ALTER TABLE holo_test ALTER COLUMN id SET DEFAULT 0;
    --删除表holo_test中id列的默认值
    ALTER TABLE holo_test ALTER COLUMN id DROP DEFAULT;

修改表属性

Hologres支持通过执行语句修改参数,达到修改表属性的目的。具体修改方式说明如下:

  • 修改dictionary_encoding_columns字典编码列
    • 使用语法
      --修改全量,即除了call里面指定的字段修改类型,系统还会把text类型自动设置为dictionary
      CALL SET_TABLE_PROPERTY('<table_name>', 'dictionary_encoding_columns', '[columnName{:[on|off|auto]}[,...]]');
      
      --修改增量,只修改call里面的指定字段,其余字段不变
      CALL UPDATE_TABLE_PROPERTY('<table_name>', 'dictionary_encoding_columns', '[columnName{:[on|off|auto]}[,...]]');
    • 参数说明
      参数 说明
      table_name 需要和待修改的表名大小写保持一致,可以携带Schema信息。
      on 表示当前字段打开dictionary_encoding_columns
      off 表示当前字段关闭dictionary_encoding_columns
      auto 表示自动。如果是设置了auto,Hologres会根据所在列数值的重复程度自动选择是否进行dictionary_encoding_columns,值的重复度越高,字典编码的收益越大。在Hologres V0.8版本及更早版本中默认所有text列都会被设置为dictionary_encoding_columns,在Hologres V0.9版本及之后版本,会根据数据特征自动选择是否创建字典编码。
    • 使用示例
      • 对a列显示创建dictionary,b列自动选择是否创建dictionary,c、d两列不创建dictionary。
        CREATE TABLE holo_test (
         a text NOT NULL,
         b text NOT NULL,
         c text NOT NULL,
         d text
        );
        CALL UPDATE_TABLE_PROPERTY('holo_test','dictionary_encoding_columns','a:on,b:auto');
      • 对a列显示关闭dictionary,系统也会自动给b、c、d字段加上dictionary索引。
        CREATE TABLE holo_test (
         a text NOT NULL,
         b text NOT NULL,
         c text NOT NULL,
         d text
        );
        CALL SET_TABLE_PROPERTY('holo_test','dictionary_encoding_columns','a:off');
  • 修改bitmap_columns比特编码列
    • 使用语法
      --修改全量,即除了call里面指定的字段修改类型,系统还会把text类型自动设置为dictionary
      CALL SET_TABLE_PROPERTY('<table_name>', 'bitmap_columns', '[columnName{:[on|off]}[,...]]');
      
      --修改增量,只修改call里面的指定字段,其余字段不变
      CALL UPDATE_TABLE_PROPERTY('<table_name>', 'bitmap_columns', '[columnName{:[on|off]}[,...]]');
    • 参数说明
      参数 说明
      table_name 需要和待修改的表名大小写保持一致,可以携带Schema信息。
      on 当前字段打开bitmap_columns
      off 当前字段关闭bitmap_columns
    • 使用示例
      • 对a列启动bitmap索引,对b、c、d不启动bitmap索引。
        CREATE TABLE holo_test (
         a text NOT NULL,
         b text NOT NULL,
         c text NOT NULL,
         d text
        );
        CALL UPDATE_TABLE_PROPERTY('holo_test','bitmap_columns','a:on');
      • 对b关闭bitmap索引,系统会自动给a、c、d创建dictionary索引。
        CREATE TABLE holo_test_1 (
         a text NOT NULL,
         b text NOT NULL,
         c text NOT NULL,
         d text
        );
        CALL SET_TABLE_PROPERTY('holo_test_1','bitmap_columns','b:off');
  • 修改表数据的生存时间
    • 使用语法
      call set_table_property('<table_name>', 'time_to_live_in_seconds', '<non_negative_literal>');
    • 参数说明
      参数 说明
      time_to_live_in_seconds 简称TTL,表数据的生存时间,单位为秒,必须是非负数字类型,整数或浮点数均可。
      说明 表数据生存时间是按照数据写入Hologres开始,在指定的时间内未被执行更新等操作,超过该指定时间,表将会在某个时间内被删除,但并不是精准的时间。
    • 使用示例
      call set_table_property('holo_test', 'time_to_live_in_seconds', '600');