ALTER TABLE

描述

ALTER TABLE 语句更改表的模式或属性。

RENAME

ALTER TABLE RENAME TO 语句更改数据库中现有表的表名。表重命名命令不能用于在数据库之间移动表，只能用于在同一数据库中重命名表。

如果表已缓存，该命令将清除表的缓存数据。下次访问该表时将惰性填充缓存。此外

表重命名命令将取消缓存所有表的依赖项，例如引用该表的视图。依赖项应再次显式缓存。
分区重命名命令清除所有表依赖项的缓存，同时保持它们处于缓存状态。因此，下次访问它们时将惰性填充其缓存。

语法

ALTER TABLE table_identifier RENAME TO table_identifier

ALTER TABLE table_identifier partition_spec RENAME TO partition_spec

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
partition_spec

要重命名的分区。请注意，可以在分区规范中使用类型化字面量（例如，date’2019-01-02’）。

语法: PARTITION ( partition_col_name = partition_col_val [ , ... ] )

ADD COLUMNS

ALTER TABLE ADD COLUMNS 语句向现有表添加指定列。

语法

ALTER TABLE table_identifier ADD COLUMNS ( col_spec [ , ... ] )

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
COLUMNS ( col_spec )

指定要添加的列。

DROP COLUMNS

ALTER TABLE DROP COLUMNS 语句从现有表中删除指定列。请注意，此语句仅支持 v2 表。

语法

ALTER TABLE table_identifier DROP { COLUMN | COLUMNS } [ ( ] col_name [ , ... ] [ ) ]

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
col_name

指定列名。

RENAME COLUMN

ALTER TABLE RENAME COLUMN 语句更改现有表的列名。请注意，此语句仅支持 v2 表。

语法

ALTER TABLE table_identifier RENAME COLUMN col_name TO col_name

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
col_name

指定列名。

ALTER OR CHANGE COLUMN

ALTER TABLE ALTER COLUMN 或 ALTER TABLE CHANGE COLUMN 语句更改列的定义。

语法

ALTER TABLE table_identifier { ALTER | CHANGE } [ COLUMN ] col_name alterColumnAction

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
col_name

指定列名。
alterColumnAction

更改列的定义。

REPLACE COLUMNS

ALTER TABLE REPLACE COLUMNS 语句移除所有现有列并添加新的列集。请注意，此语句仅支持 v2 表。

语法

ALTER TABLE table_identifier [ partition_spec ] REPLACE COLUMNS  
  [ ( ] qualified_col_type_with_position_list [ ) ]

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
partition_spec

要替换的分区。请注意，可以在分区规范中使用类型化字面量（例如，date’2019-01-02’）。

语法: PARTITION ( partition_col_name = partition_col_val [ , ... ] )
qualified_col_type_with_position_list

要添加的列列表

语法: col_name col_type [ col_comment ] [ col_position ] [ , ... ]

ADD AND DROP PARTITION

ADD PARTITION

ALTER TABLE ADD 语句向分区表添加分区。

如果表已缓存，该命令将清除表的缓存数据以及所有引用它的依赖项。下次访问表或依赖项时将惰性填充缓存。

语法

ALTER TABLE table_identifier ADD [IF NOT EXISTS] 
    ( partition_spec [ partition_spec ... ] )

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
partition_spec

要添加的分区。请注意，可以在分区规范中使用类型化字面量（例如，date’2019-01-02’）。

语法: PARTITION ( partition_col_name = partition_col_val [ , ... ] )

DROP PARTITION

ALTER TABLE DROP 语句删除表的指定分区。

如果表已缓存，该命令将清除表的缓存数据以及所有引用它的依赖项。下次访问表或依赖项时将惰性填充缓存。

语法

ALTER TABLE table_identifier DROP [ IF EXISTS ] partition_spec [PURGE]

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
partition_spec

要删除的分区。请注意，可以在分区规范中使用类型化字面量（例如，date’2019-01-02’）。

语法: PARTITION ( partition_col_name = partition_col_val [ , ... ] )

CLUSTER BY

ALTER TABLE CLUSTER BY 命令也可以用于更改或移除现有表的聚簇列。

语法

-- Changing Clustering Columns
ALTER TABLE table_identifier CLUSTER BY ( col_name [ , ... ] )

-- Removing Clustering Columns
ALTER TABLE table_identifier CLUSTER BY NONE

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
col_name

指定列名。

SET AND UNSET

SET PROPERTIES

ALTER TABLE SET 命令用于设置表属性。如果某个特定属性已设置，此命令将使用新值覆盖旧值。

语法

-- Set Properties
ALTER TABLE table_identifier SET TBLPROPERTIES ( key1 = val1, key2 = val2, ... )

UNSET PROPERTIES

ALTER TABLE UNSET 命令用于删除表属性。

注意: 如果指定的属性键不存在，无论是否指定 IF EXISTS，该命令都将忽略它并最终成功。

语法

-- Unset Properties
ALTER TABLE table_identifier UNSET TBLPROPERTIES ( key1, key2, ... )

SET SERDE

ALTER TABLE SET 命令用于在 Hive 表中设置 SERDE 或 SERDE 属性。如果某个特定属性已设置，此命令将使用新值覆盖旧值。

语法

-- Set SERDE Properties
ALTER TABLE table_identifier [ partition_spec ]
    SET SERDEPROPERTIES ( key1 = val1, key2 = val2, ... )

ALTER TABLE table_identifier [ partition_spec ] SET SERDE serde_class_name
    [ WITH SERDEPROPERTIES ( key1 = val1, key2 = val2, ... ) ]

SET LOCATION 和 SET FILE FORMAT

ALTER TABLE SET 命令也可以用于更改现有表的文件位置和文件格式。

如果表已缓存，ALTER TABLE .. SET LOCATION 命令将清除表的缓存数据以及所有引用它的依赖项。下次访问表或依赖项时将惰性填充缓存。

语法

-- Changing File Format
ALTER TABLE table_identifier [ partition_spec ] SET FILEFORMAT file_format

-- Changing File Location
ALTER TABLE table_identifier [ partition_spec ] SET LOCATION 'new_location'

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name
partition_spec

指定要设置属性的分区。请注意，可以在分区规范中使用类型化字面量（例如，date’2019-01-02’）。

语法: PARTITION ( partition_col_name = partition_col_val [ , ... ] )
SERDEPROPERTIES ( key1 = val1, key2 = val2, … )

指定要设置的 SERDE 属性。

RECOVER PARTITIONS

ALTER TABLE RECOVER PARTITIONS 语句恢复表目录中的所有分区并更新 Hive metastore。另一种恢复分区的方法是使用 MSCK REPAIR TABLE。

语法

ALTER TABLE table_identifier RECOVER PARTITIONS

参数

table_identifier

指定表名，可选择用数据库名限定。

语法: [ database_name. ] table_name

示例

-- RENAME table 
DESC student;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|                   name|   string|   NULL|
|                 rollno|      int|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

ALTER TABLE Student RENAME TO StudentInfo;

-- After Renaming the table
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|                   name|   string|   NULL|
|                 rollno|      int|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

-- RENAME partition

SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=10|
|   age=11|
|   age=12|
+---------+

ALTER TABLE default.StudentInfo PARTITION (age='10') RENAME TO PARTITION (age='15');

-- After renaming Partition
SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=11|
|   age=12|
|   age=15|
+---------+

-- Add new columns to a table
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|                   name|   string|   NULL|
|                 rollno|      int|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

ALTER TABLE StudentInfo ADD columns (LastName string, DOB timestamp);

-- After Adding New columns to the table
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|                   name|   string|   NULL|
|                 rollno|      int|   NULL|
|               LastName|   string|   NULL|
|                    DOB|timestamp|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

-- Drop columns of a table
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|                   name|   string|   NULL|
|                 rollno|      int|   NULL|
|               LastName|   string|   NULL|
|                    DOB|timestamp|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

ALTER TABLE StudentInfo DROP columns (LastName, DOB);

-- After dropping columns of the table
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|                   name|   string|   NULL|
|                 rollno|      int|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

-- Rename a column of a table
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|                   name|   string|   NULL|
|                 rollno|      int|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

ALTER TABLE StudentInfo RENAME COLUMN name TO FirstName;

-- After renaming a column of the table
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|              FirstName|   string|   NULL|
|                 rollno|      int|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

-- ALTER OR CHANGE COLUMNS
DESC StudentInfo;
+-----------------------+---------+-------+
|               col_name|data_type|comment|
+-----------------------+---------+-------+
|              FirstName|   string|   NULL|
|                 rollno|      int|   NULL|
|                    age|      int|   NULL|
|# Partition Information|         |       |
|             # col_name|data_type|comment|
|                    age|      int|   NULL|
+-----------------------+---------+-------+

ALTER TABLE StudentInfo ALTER COLUMN FirstName COMMENT "new comment";

-- After ALTER or CHANGE COLUMNS
DESC StudentInfo;
+-----------------------+---------+-----------+
|               col_name|data_type|    comment|
+-----------------------+---------+-----------+
|              FirstName|   string|new comment|
|                 rollno|      int|       NULL|
|                    age|      int|       NULL|
|# Partition Information|         |           |
|             # col_name|data_type|    comment|
|                    age|      int|       NULL|
+-----------------------+---------+-----------+

-- REPLACE COLUMNS
DESC StudentInfo;
+-----------------------+---------+-----------+
|               col_name|data_type|    comment|
+-----------------------+---------+-----------+
|              FirstName|   string|new comment|
|                 rollno|      int|       NULL|
|                    age|      int|       NULL|
|# Partition Information|         |           |
|             # col_name|data_type|    comment|
|                    age|      int|       NULL|
+-----------------------+---------+-----------+

ALTER TABLE StudentInfo REPLACE COLUMNS (name string, ID int COMMENT 'new comment');

-- After replacing COLUMNS
DESC StudentInfo;
+-----=---------+---------+-----------+
|       col_name|data_type|    comment|
+---------------+---------+-----------+
|           name|   string|       NULL|
|             ID|      int|new comment|
| # Partitioning|         |           |
|Not partitioned|         |           |
+---------------+---------+-----------+

-- Add a new partition to a table 
SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=11|
|   age=12|
|   age=15|
+---------+

ALTER TABLE StudentInfo ADD IF NOT EXISTS PARTITION (age=18);

-- After adding a new partition to the table
SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=11|
|   age=12|
|   age=15|
|   age=18|
+---------+

-- Drop a partition from the table 
SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=11|
|   age=12|
|   age=15|
|   age=18|
+---------+

ALTER TABLE StudentInfo DROP IF EXISTS PARTITION (age=18);

-- After dropping the partition of the table
SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=11|
|   age=12|
|   age=15|
+---------+

-- Adding multiple partitions to the table
SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=11|
|   age=12|
|   age=15|
+---------+

ALTER TABLE StudentInfo ADD IF NOT EXISTS PARTITION (age=18) PARTITION (age=20);

-- After adding multiple partitions to the table
SHOW PARTITIONS StudentInfo;
+---------+
|partition|
+---------+
|   age=11|
|   age=12|
|   age=15|
|   age=18|
|   age=20|
+---------+

-- CLUSTER BY
DESC Teacher;
+------------------------+---------+-------+
|                col_name|data_type|comment|
+------------------------+---------+-------+
|                    name|   string|   NULL|
|                  gender|   string|   NULL|
|                 country|   string|   NULL|
|                     age|      int|   NULL|
|# Clustering Information|         |       |
|              # col_name|data_type|comment|
|                  gender|   string|   NULL|
+------------------------+---------+-------+

ALTER TABLE Teacher CLUSTER BY (gender, country);

-- After changing clustering columns
DESC Teacher;
+------------------------+---------+-------+
|                col_name|data_type|comment|
+------------------------+---------+-------+
|                    name|   string|   NULL|
|                  gender|   string|   NULL|
|                 country|   string|   NULL|
|                     age|      int|   NULL|
|# Clustering Information|         |       |
|              # col_name|data_type|comment|
|                  gender|   string|   NULL|
|                 country|   string|   NULL|
+------------------------+---------+-------+

ALTER TABLE Teacher CLUSTER BY NONE;

-- After removing clustering columns
DESC Teacher;
+------------------------+---------+-------+
|                col_name|data_type|comment|
+------------------------+---------+-------+
|                    name|   string|   NULL|
|                  gender|   string|   NULL|
|                 country|   string|   NULL|
|                     age|      int|   NULL|
|# Clustering Information|         |       |
+------------------------+---------+-------+

-- Change the fileformat
ALTER TABLE loc_orc SET fileformat orc;

ALTER TABLE p1 partition (month=2, day=2) SET fileformat parquet;

-- Change the file Location
ALTER TABLE dbx.tab1 PARTITION (a='1', b='2') SET LOCATION '/path/to/part/ways';

-- SET SERDE/ SERDE Properties
ALTER TABLE test_tab SET SERDE 'org.apache.hadoop.hive.serde2.columnar.LazyBinaryColumnarSerDe';

ALTER TABLE dbx.tab1 SET SERDE 'org.apache.hadoop' WITH SERDEPROPERTIES ('k' = 'v', 'kay' = 'vee');

-- SET TABLE PROPERTIES
ALTER TABLE dbx.tab1 SET TBLPROPERTIES ('winner' = 'loser');

-- SET TABLE COMMENT Using SET PROPERTIES
ALTER TABLE dbx.tab1 SET TBLPROPERTIES ('comment' = 'A table comment.');

-- Alter TABLE COMMENT Using SET PROPERTIES
ALTER TABLE dbx.tab1 SET TBLPROPERTIES ('comment' = 'This is a new comment.');

-- DROP TABLE PROPERTIES
ALTER TABLE dbx.tab1 UNSET TBLPROPERTIES ('winner');

-- RECOVER PARTITIONS
ALTER TABLE dbx.tab1 RECOVER PARTITIONS;

Spark SQL 指南