更新时间: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');
参数描述
参数 |
描述 |
---|---|
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命令,可显示新添加的列。
父主题: DDL