文档首页/ 数据湖探索 DLI/ Delta SQL语法参考/ Delta SQL语法参考/ Schema演进语法说明/ RENAME COLUMN
更新时间：2024-12-25 GMT+08:00
查看PDF
分享

RENAME COLUMN

命令功能

ALTER TABLE ... RENAME COLUMN语法用于修改列名称。

注意事项

  • 如果您的表已经在所需的协议版本上，需要先执行如下语句才能修改成功： 
    ALTER TABLE table_name SET TBLPROPERTIES ('delta.columnMapping.mode' = 'name')；
  • 如果您的表不在所需的协议版本上，需要先执行如下语句才能修改成功： 
    ALTER TABLE table_name SET TBLPROPERTIES (
'delta.columnMapping.mode' = 'name',
'delta.minReaderVersion' = '2',
'delta.minWriterVersion' = '5')

命令语法

ALTER TABLE tableName RENAME COLUMN old_columnName TO new_columnName

参数描述

表1 参数描述

参数

描述

tableName

表名。

old_columnName

旧列名。

new_columnName

新列名。

所需权限

  • SQL权限
表2 ALTER TABLE所需权限列表

权限描述

表的ALTER权限
  • 细粒度权限：dli:table:alter。
  • 由LakeFormation提供的元数据服务，权限配置详见LakeFormation文档。

示例

ALTER TABLE table1 RENAME COLUMN addr to address

ALTER TABLE table1 RENAME COLUMN addr.priv to province

a.b.c 表示嵌套列全路径，嵌套列具体规则见ADD COLUMNS。

系统响应

通过运行DESCRIBE命令查看表列修改。

相关文档