列操作

MaxCompute SQL的列操作命令如下。

使用限制

添加列或注释

为已存在的非分区表或分区表添加列或注释。

• 命令格式

  ALTER TABLE <table_name> 
        ADD columns [if NOT EXISTS]
            (<col_name1> <type1> comment ['<col_comment>']
             [, <col_name2> <type2> comment '<col_comment>'...]
            );

• 参数说明

  参数	是否必填	说明
  table_name	是	待新增列的表名称。添加的新列不支持指定顺序，默认在最后一列。
  col_name	是	新增列的名称。
  type	是	新增列的数据类型。
  col_comment	否	新增列的注释。

• 使用示例

  • 示例1：给表sale_detail添加两个列。

    ALTER TABLE sale_detail ADD columns if NOT EXISTS(customer_name STRING, education BIGINT);

  • 示例2：给表sale_detail添加两个列并同时添加列注释。

    ALTER TABLE sale_detail ADD columns (customer_name STRING comment '客户', education BIGINT comment '教育' );

  • 示例3：给表sale_detail添加一个复杂数据类型列。

    ALTER TABLE sale_detail ADD columns (region struct<province:string, area:string>);

  • 示例4：增加Delta Table的列。

    ALTER TABLE mf_tt ADD columns (val2 bigint);

  • 示例5：给表sale_detail增加ID列SQL会返回成功，但实际并不会重复增加。

    --返回成功，但实际并不会重复增加ID列
    ALTER TABLE sale_detail ADD columns if NOT EXISTS(id bigint);

删除列

为已存在的非分区表或分区表删除指定的单个或多个列。

setproject odps.schema.evolution.enable=true;

• 命令格式

  ALTER TABLE <table_name> DROP columns <col_name1>[, <col_name2>...];

• 参数说明

  参数	是否必填	说明
  table_name	是	待删除列的表名称。
  col_name	是	待删除的列名称。

• 示例：删除表的列

  --删除表sale_detail的列customer_id。输入yes确认后，即可删除列。
  ALTER TABLE sale_detail DROP columns customer_id;
  
  --删除表sale_detail的列shop_name和customer_id。输入yes确认后，即可删除列。
  ALTER TABLE sale_detail DROP columns shop_name, customer_id;

更改列数据类型

为已存在的列更改数据类型。

setproject odps.schema.evolution.enable=true;

• 命令格式。

  ALTER TABLE <table_name> change [COLUMN] <old_column_name> <new_column_name> <new_data_type>;

• 参数说明。

  参数	是否必填	说明
  table_name	是	待修改列数据类型的表名称。
  old_column_name	是	待修改列数据类型的列名称。
  new_column_name	是	修改列数据类型后的列名称。 说明 old_column_name可以与new_column_name保持一致，表示不修改列名称。但是new_column_name不能与除old_column_name之外的列名称相同。
  new_data_type	是	待修改的列修改后的数据类型。

• 使用示例。

  --将mf_evol_t3表的id字段由int转化为bigint
  ALTER TABLE mf_evol_t3 change id id bigint;
  --将mf_evol_t3表的id字段类型由bigint转化为string
  ALTER TABLE mf_evol_t3 change COLUMN id id string;

• 数据类型支持转换表。

  说明

  Y表示支持转换；N表示不支持转换；-表示不涉及；Y（）表示满足括号内的条件支持转换。

  

修改列的顺序

为已存在的非分区表或分区表修改列顺序。

setproject odps.schema.evolution.enable=true;

• 命令格式

  ALTER TABLE <table_name> change <old_column_name> <new_column_name> <column_type> after <column_name>;

• 参数说明

  参数	是否必填	说明
  table_name	是	待修改列顺序的表名称。
  old_column_name	是	待修改顺序的列的原始名称。
  new_col_name	是	修改后的列名称。 说明 new_col_name可以与old_column_name保持一致，表示不修改列名称。但new_col_name不能与除old_column_name的之外的列名称相同。
  column_type	是	待修改的列的原始数据类型。不可修改。
  column_name	是	将待调整顺序的列调整至column_name之后。

• 使用示例

  --修改表sale_detail的列customer_id为customer并位于total_price之后。
  ALTER TABLE sale_detail change customer_id customer string after total_price;
  --修改表sale_detail的列customer_id位于total_price之后，不修改列名称。
  ALTER TABLE sale_detail change customer_id customer_id string after total_price;

修改列名

为已存在的非分区表或分区表修改列名称。

• 命令格式

  ALTER TABLE <table_name> change COLUMN <old_col_name> rename TO <new_col_name>;

• 参数说明

  参数	是否必填	说明
  table_name	是	待修改列名的表名称。
  old_col_name	是	待修改的列名称。 说明 必须是已存在的列。
  new_col_name	是	修改后的列名称，列名称不能重复。

• 使用示例

  --修改表sale_detail的列名customer_name为customer。
  ALTER TABLE sale_detail change COLUMN customer_name rename TO customer;

修改列注释

为已存在的非分区表或分区表修改列注释。

• 语法格式

  ALTER TABLE <table_name> change COLUMN <col_name> comment '<col_comment>';

• 参数说明

  参数	是否必填	说明
  table_name	是	待修改列注释的表名称。
  col_name	是	待修改注释的列名称。 说明 必须是已存在的列。
  col_comment	是	修改后的注释信息。注释内容为长度不超过1024字节的有效字符串，否则报错。

• 使用示例

  --修改表sale_detail的列customer的注释。
  ALTER TABLE sale_detail change COLUMN customer comment 'customer';

修改列名及注释

修改表的列非空属性

修改表的非分区列的非空属性。即如果表的非分区列值禁止为NULL，您可以通过本命令修改分区列值允许为NULL。

您可以通过desc extended table_name;命令查看Nullable属性值，判断列的非空属性。如果Nullable为true，表示允许为NULL；如果Nullable为false，表示禁止为NULL。

• 使用限制

  修改分区列值允许为NULL后，不可回退，不支持再修改分区列值禁止为NULL，请谨慎操作。

• 命令格式

  ALTER TABLE <table_name> change COLUMN <old_col_name> NULL;

• 参数说明

  参数	是否必填	说明
  table_name	是	待修改列非空属性的表名称。
  old_col_name	是	待修改的非分区列的名称。 说明 必须是已存在的非分区列。

• 使用示例

  --创建一张分区表，id列禁止为NULL。
  CREATE TABLE null_test(id int NOT NULL, name string) partitioned BY (ds string);
  --修改id列允许为NULL。
  ALTER TABLE null_test change COLUMN id NULL;

相关文档

更多关于表操作命令详情，请参见：

• 创建和删除表

• 修改表

• 分区和列操作

• 查看表和视图

• CLONE TABLE