描述

该语句用来修改已存在的表的结构，比如：修改表及表属性、新增列、修改列及属性、删除列等。

格式

  1. alter_table_stmt:
  2.       ALTER TABLE table_name
  3.       alter_table_action_list;
  4.     | RENAME TABLE rename_table_action_list;
  6. alter_table_action_list:
  7.     alter_table_action [, alter_table_action ...]
  9. alter_table_action:
  10.       ADD [COLUMN] {column_definition | (column_definition_list)}
  11.     | CHANGE [COLUMN] column_name column_definition
  12.     | MODIFY [COLUMN] column_definition
  13.     | ALTER [COLUMN] column_name {SET DEFAULT const_value | DROP DEFAULT}
  14.     | DROP [COLUMN] column_name
  15.     | ADD [CONSTRAINT [constraint_name]] UNIQUE {INDEX | KEY} [index_name] index_desc
  16.     | ADD {INDEX | KEY} [index_name] index_desc
  17.     | ADD FULLTEXT [INDEX | KEY] [index_name] fulltext_index_desc
  18.     | ALTER INDEX index_name [VISIBLE | INVISIBLE]
  19.     | DROP {INDEX | KEY} index_name
  20.     | ADD PARTITION (range_partition_list)
  21.     | DROP PARTITION (partition_name_list)
  22.     | REORGANIZE PARTITION name_list INTO partition_range_or_list
  23.     | TRUNCATE PARTITION name_list
  24.     | [SET] table_option_list
  25.     | RENAME [TO] table_name
  26.     | DROP TABLEGROUP
  27.     | DROP FOREIGN KEY fk_name
  29. rename_table_action_list:
  30.     rename_table_action [, rename_table_action ...]
  32. rename_table_action:
  33.     table_name TO table_name
  35. column_definition_list:
  36.     column_definition [, column_definition ...]
  38. column_definition:
  39.     column_name data_type
  40.     [DEFAULT const_value] [AUTO_INCREMENT]
  41.     [NULL | NOT NULL] [[PRIMARY] KEY] [UNIQUE [KEY]] comment
  43. index_desc:
  44.    (column_desc_list) [index_type] [index_option_list]
  46. fulltext_index_desc:
  47.    (column_desc_list) CTXCAT(column_desc_list) [index_option_list]
  49. column_desc_list:
  50.     column_desc [, column_desc ...]
  52. column_desc:
  53.      column_name [(length)] [ASC | DESC]
  55. index_type:
  56.     USING BTREE
  58. index_option_list:
  59.     index_option [ index_option ...]
  61. index_option:
  62.       [GLOBAL | LOCAL]
  63.     | block_size
  64.     | compression
  65.     | STORING(column_name_list)
  66.     | comment
  68. table_option_list:
  69.     table_option [ table_option ...]
  71. table_option:
  72.     | primary_zone
  73.     | replica_num
  74.     | table_tablegroup
  75.     | block_size
  76.     | compression
  77.     | AUTO_INCREMENT [=] INT_VALUE
  78.     | comment
  79.     | DUPLICATE_SCOPE [=] "none|zone|region|cluster"
  81. partition_option:
  82.       PARTITION BY HASH(expression)
  83.       [subpartition_option] PARTITIONS partition_count
  84.     | PARTITION BY KEY([column_name_list])
  85.       [subpartition_option] PARTITIONS partition_count
  86.     | PARTITION BY RANGE {(expression) | COLUMNS (column_name_list)}
  87.       [subpartition_option] (range_partition_list)
  89. subpartition_option:
  90.       SUBPARTITION BY HASH(expression)
  91.       SUBPARTITIONS subpartition_count
  92.     | SUBPARTITION BY KEY(column_name_list)
  93.       SUBPARTITIONS subpartition_count
  94.     | SUBPARTITION BY RANGE {(expression) | COLUMNS (column_name_list)}
  95.       (range_subpartition_list)
  97. range_partition_list:
  98.     range_partition [, range_partition ...]
  100. range_partition:
  101.     PARTITION partition_name
  102.     VALUES LESS THAN {(expression_list) | MAXVALUE}
  104. range_subpartition_list:
  105.     range_subpartition [, range_subpartition ...]
  107. range_subpartition:
  108.     SUBPARTITION subpartition_name
  109.     VALUES LESS THAN {(expression_list) | MAXVALUE}
  111. expression_list:
  112.     expression [, expression ...]
  114. column_name_list:
  115.     column_name [, column_name ...]
  117. partition_name_list:
  118.     partition_name [, partition_name ...]
  120. partition_count | subpartition_count:
  121.     INT_VALUE

参数解释

参数

描述

ADD [COLUMN]增加列，目前不支持增加主键列。
CHANGE [COLUMN]修改列名和列属性。
MODIFY [COLUMN]修改列属性。
ALTER [COLUMN]修改列的默认值。
DROP [COLUMN]删除列，不允许删除主键列或者包含索引的列。
ADD [UNIQUE INDEX]增加唯一索引。
ADD [INDEX]增加普通索引
ALTER [INDEX]修改索引属性。
ADD [PARTITION]增加分区。
DROP [PARTITION]删除分区。
REORGANIZE [PARTITION]分区重组。
TRUNCATE [PARTITION]删除分区数据。
RENAME [TO] table_name表重命名。
DROP [TABLEGROUP]删除表组。
DROP [FOREIGN KEY]删除外键。
SET BLOCK_SIZE设置Partition表BLOCK大小。
SET REPLICA_NUM设置表的副本数（指表的副本总数）。
SET COMPRESSION设置表的压缩方式。
SET USE_BLOOM_FILTER设置是否使用BloomFilter。
SET COMMENT设置注释信息。
SET PROGRESSIVE_MERGE_NUM设置渐进合并步数，取值范围是1~64。

示例

  • 把表t2的字段d改名为c，并同时修改字段类型
  1. ALTER TABLE t2 CHANGE COLUMN d c CHAR(10);

  • 增加、删除列

  • 增加列前，执行DESCRIBE test; 命令查看表信息，如下图所示：

image.png

  • 执行以下命令增加c3列
  1. ALTER TABLE test ADD c3 int;
  • 增加列后，执行DESCRIBE test; 命令查看表信息，如下图所示：

image.png

  • 执行以下命令删除c3列
  1. ALTER TABLE test DROP c3;
  • 删除列后，执行DESCRIBE test; 命令查看表信息，如下图所示：

image.png

  • 设置表格test的副本数，并且增加列c5
  1. ALTER TABLE test SET REPLICA_NUM=2, ADD COLUMN c5 INT;