更新时间:2022-12-14 GMT+08:00

ADD COLUMNS

命令功能

ADD COLUMNS命令用于为现有表添加新列。

命令语法

ALTER TABLE [db_name.]table_name ADD COLUMNS (col_name data_type,...) TBLPROPERTIES(''COLUMNPROPERTIES.columnName.shared_column'='sharedFolder.sharedColumnName,...', 'DEFAULT.VALUE.COLUMN_NAME'='default_value');

参数描述

表1 ADD COLUMNS参数描述

参数

描述

db_name

数据库名。若未指定,则选择当前数据库。

table_name

表名。

col_name data_type

带数据类型且用逗号分隔的列的名称。列名称包含字母,数字和下划线(_)。

说明:

创建CarbonData表时,不要将列名命名为tupleId,PositionId和PositionReference,因为将在UPDATE,DELETE和二级索引命令内部使用这些名称。

注意事项

  • 除了shared_column和default_value之外,将不会读取其他属性。如果指定了任何其他属性名称,则不会抛出错误,其他属性将被忽略。
  • 如果未指定默认值,则新列的默认值将被视为null。
  • 如果在该列上应用filter,则在排序期间不会考虑新增列,新增列可能会影响查询性能。

示例

  • ALTER TABLE carbon ADD COLUMNS (a1 INT, b1 STRING);
  • ALTER TABLE carbon ADD COLUMNS (a1 INT, b1 STRING) TBLPROPERTIES('COLUMNPROPERTIES.b1.shared_column'='sharedFolder.b1');
  • ALTER TABLE carbon ADD COLUMNS (a1 INT, b1 STRING) TBLPROPERTIES('DEFAULT.VALUE.a1'='10');

系统响应

通过运行DESCRIBE命令,可显示新添加的列。