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