Skip to main content

ALTER TABLE COMMENT

Introduced or updated: v1.2.419

修改表的注释。如果表还没有注释,此命令会将指定的注释添加到表中。

语法

ALTER TABLE [ IF EXISTS ] [ <database_name>. ]<table_name> 
COMMENT = '<comment>'

示例

此示例创建一个带有注释的表,然后在之后修改注释:

-- 创建一个带有注释的表
CREATE TABLE t(id INT) COMMENT ='original-comment';

SHOW CREATE TABLE t;

┌──────────────────────────────────────────────────────────────────────────────────────┐
TableCreate Table
├────────┼─────────────────────────────────────────────────────────────────────────────┤
│ t │ CREATE TABLE t (\n id INT NULL\n) ENGINE=FUSE COMMENT = 'original-comment'
└──────────────────────────────────────────────────────────────────────────────────────┘

-- 修改注释
ALTER TABLE t COMMENT = 'new-comment';

SHOW CREATE TABLE t;

┌─────────────────────────────────────────────────────────────────────────────────┐
TableCreate Table
├────────┼────────────────────────────────────────────────────────────────────────┤
│ t │ CREATE TABLE t (\n id INT NULL\n) ENGINE=FUSE COMMENT = 'new-comment'
└─────────────────────────────────────────────────────────────────────────────────┘

此示例创建一个没有注释的表,然后在之后向表中添加注释:

-- 创建一个没有注释的表
CREATE TABLE t(id INT);

SHOW CREATE TABLE t;

┌─────────────────────────────────────────────────────────┐
TableCreate Table
├────────┼────────────────────────────────────────────────┤
│ t │ CREATE TABLE t (\n id INT NULL\n) ENGINE=FUSE │
└─────────────────────────────────────────────────────────┘

-- 添加注释
ALTER TABLE t COMMENT = 'new-comment';

SHOW CREATE TABLE t;

┌─────────────────────────────────────────────────────────────────────────────────┐
TableCreate Table
├────────┼────────────────────────────────────────────────────────────────────────┤
│ t │ CREATE TABLE t (\n id INT NULL\n) ENGINE=FUSE COMMENT = 'new-comment'
└─────────────────────────────────────────────────────────────────────────────────┘
Explore Databend Cloud for FREE
Low-cost
Fast Analytics
Easy Data Ingestion
Elastic Scaling
Try it today