ALTER TABLE - Amazon Redshift
语法参数
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

ALTER TABLE

主题

更改数据库表或 Amazon Redshift Spectrum 外部表的定义。此命令更新 CREATE TABLE 或 CREATE EXTERNAL TABLE 设置的值和属性。

您不能在以下事务块内的外部表上运行 ALTER TABLE：(BEGIN ...。有关事务的更多信息，请参阅 可序列化的隔离。

注意

ALTER TABLE 锁定表以便执行读写操作，直到包含 ALTER TABLE 操作的事务完成。

语法

ALTER TABLE table_name
{
ADD table_constraint 
| DROP CONSTRAINT constraint_name [ RESTRICT | CASCADE ] 
| OWNER TO new_owner 
| RENAME TO new_name 
| RENAME COLUMN column_name TO new_name            
| ALTER COLUMN column_name TYPE new_data_type              
| ALTER DISTKEY column_name 
| ALTER DISTSTYLE ALL       
| ALTER DISTSTYLE EVEN
| ALTER DISTSTYLE KEY DISTKEY column_name   
| ALTER [COMPOUND] SORTKEY ( column_name [,...] )             
| ADD [ COLUMN ] column_name column_type
  [ DEFAULT default_expr ]
  [ ENCODE encoding ]
  [ NOT NULL | NULL ] |
| DROP [ COLUMN ] column_name [ RESTRICT | CASCADE ] }

where table_constraint is:

[ CONSTRAINT constraint_name ]
{ UNIQUE ( column_name [, ... ] )  
| PRIMARY KEY ( column_name [, ... ] ) 
| FOREIGN KEY (column_name [, ... ] )
   REFERENCES  reftable [ ( refcolumn ) ]}

The following options apply only to external tables:

SET LOCATION { 's3://bucket/folder/' | 's3://bucket/manifest_file' } 
| SET FILE FORMAT format |
| SET TABLE PROPERTIES ('property_name'='property_value') 
| PARTITION ( partition_column=partition_value [, ...] ) 
  SET LOCATION { 's3://bucket/folder' |'s3://bucket/manifest_file' } 
| ADD [IF NOT EXISTS] 
    PARTITION ( partition_column=partition_value [, ...] ) LOCATION { 's3://bucket/folder' |'s3://bucket/manifest_file' }
    [, ... ]
| DROP PARTITION ( partition_column=partition_value [, ...] )

要减少运行 ALTER TABLE 命令的时间，可以结合使用 ALTER TABLE 命令的一些子句。

Amazon Redshift 支持以下 ALTER TABLE 子句组合：

ALTER TABLE tablename ALTER SORTKEY (column_list), ALTER DISTKEY column_Id;
ALTER TABLE tablename ALTER DISTKEY column_Id, ALTER SORTKEY (column_list);
ALTER TABLE tablename ALTER SORTKEY (column_list), ALTER DISTSTYLE ALL;
ALTER TABLE tablename ALTER DISTSTYLE ALL, ALTER SORTKEY (column_list);

参数

table_name

要修改的表的名称。只指定表的名称，或者通过格式 schema_name.table_name 使用特定 schema。外部表必须通过一个外部 schema 名称进行限定。如果您使用 ALTER TABLE 语句重命名视图或更改其所有者，您还可以指定视图名称。表名称的最大长度为 127 个字节；更长的名称将被截断为 127 个字节。您可以使用 UTF-8 多字节字符，每个字符最多为四个字节。有关有效名称的更多信息，请参阅名称和标识符。

ADD table_constraint

用于将指定约束添加到表的子句。有关有效 table_constraint 值的描述，请参阅 CREATE TABLE。

注意

您不能将主键约束添加到可为空的列。如果列最初是使用 NOT NULL 约束创建的，您可以添加主键约束。

DROP CONSTRAINT constraint_name

用于从表中删除指定约束的子句。要删除约束，请指定约束名称而不是约束类型。要查看表约束名称，请运行以下查询。

select constraint_name, constraint_type 
from information_schema.table_constraints;
RESTRICT

用于仅删除指定约束的子句。RESTRICT 是 DROP CONSTRAINT 的一个选项。RESTRICT 不能与 CASCADE 一起使用。

CASCADE

用于删除指定约束和依赖于该约束的任何内容的子句。CASCADE 是 DROP CONSTRAINT 的选项。CASCADE 不能与 RESTRICT 一起使用。

OWNER TO new_owner

用于将表 (或视图) 的所有者更改为 new_owner 值的子句。

RENAME TO new_name

用于将表 (或视图) 重命名为 new_name 中指定的值的子句。表名称的最大长度为 127 个字节；更长的名称将被截断为 127 个字节。

您不能将永久表重命名为以“#”开头的表。名称以“#”开头的表是临时表。

您无法重命名外部表。

ALTER COLUMN column_name TYPE new_data_type

这是一个更改定义为 VARCHAR 数据类型的列大小的子句。请考虑以下限制：

  • 您无法修改具有 BYTEDICT、RUNLENGTH、TEXT255 或 TEXT32K 压缩编码的列。

  • 您无法将大小减少到小于现有数据的最大大小。

  • 您无法更改具有默认值的列。

  • 您无法更改具有 UNIQUE、PRIMARY KEY 或 FOREIGN KEY 的列。

  • 您不能更改以下事务块中的列：(BEGIN ...。有关事务的更多信息，请参阅 可序列化的隔离。

ALTER DISTSTYLE ALL

用于将表的现有分配样式更改为 ALL 的子句。请考虑以下事项：

  • ALTER DISTSYTLE、ALTER SORTKEY 和 VACUUM 不能同时对同一个表运行。

    • 如果 VACUUM 当前正在运行，则运行 ALTER DISTSTYLE ALL 将返回错误。

    • 如果 ALTER DISTSTYLE ALL 正在运行，则不在表上启动后台 vacuum。

  • 对于具有交错排序键和临时表的表，不支持 ALTER DISTSTYLE ALL 命令。

有关 DISTSTYLE ALL 的更多信息，请参阅 CREATE TABLE。

ALTER DISTSTYLE EVEN

用于将表的现有分配样式更改为 EVEN 的子句。请考虑以下事项：

  • ALTER DISTSYTLE、ALTER SORTKEY 和 VACUUM 不能同时对同一个表运行。

    • 如果 VACUUM 当前正在运行，则运行 ALTER DISTSTYLE EVEN 将返回错误。

    • 如果 ALTER DISTSTYLE EVEN 正在运行，则不在表上启动后台 Vacuum。

  • 对于具有交错排序键和临时表的表，不支持 ALTER DISTSTYLE EVEN 命令。

有关 DISTSTYLE EVEN 的更多信息，请参阅 CREATE TABLE。

ALTER DISTKEY column_name 或 ALTER DISTSTYLE KEY DISTKEY column_name

一个子句，可更改用作表的分配键的列。请考虑以下事项：

  • 不能在同一个表上并发运行 VACUUM 和 ALTER DISTKEY。

    • 如果 VACUUM 已经运行，则 ALTER DISTKEY 返回错误。

    • 如果 ALTER DISTKEY 正在运行，则不在表上启动后台 Vacuum。

    • 如果 ALTER DISTKEY 正在运行，则前台 vacuum 会返回错误。

  • 您一次只能在一个表上运行一个 ALTER DISTKEY 命令。

  • 具有交错排序键的表不支持 ALTER DISTKEY 命令。

指定 DISTSTYLE KEY 时，按 DISTKEY 列中的值分配数据。有关 DISTSTYLE 的更多信息，请参阅 CREATE TABLE。

ALTER [COMPOUND] SORTKEY ( column_name [,...] )

一个旨在更改或添加用于表的排序键的子句。

当您更改排序键时，新排序键或原始排序键中列的压缩编码可能会更改。如果没有为表显式定义编码，则 Amazon Redshift 按如下方式自动分配压缩编码：

  • 为定义为排序键的列分配 RAW 压缩。

  • 为定义为 BOOLEAN、REAL 或 DOUBLE PRECISION 数据类型的列分配 RAW 压缩。

  • 定义为 SMALLINT、INTEGER、BIGINT、DECIMAL、DATE、TIMESTAMP 或 TIMESTAMPTZ 的列分配了 AZ64 压缩。

  • 定义为 CHAR 或 VARCHAR 的列分配了 LZO 压缩。

请考虑以下事项：

  • 最多可以为每个表的排序键定义 400 列。

  • 您只能更改复合排序键。您不能更改交错排序键。

将数据加载到表中时，将按照排序键的顺序加载数据。更改排序键时，Amazon Redshift 对数据重新排序。有关 SORTKEY 的更多信息，请参阅 CREATE TABLE。

RENAME COLUMN column_name TO new_name

用于将列重命名为 new_name 中指定的值的子句。列名称的最大长度为 127 个字节；更长的名称将被截断为 127 个字节。有关有效名称的更多信息，请参阅名称和标识符。

ADD [ COLUMN ] column_name

用于将具有指定名称的列添加到表的子句。您在每个 ALTER TABLE 语句中只能修改一列。

您无法添加用作表的分配键 (DISTKEY) 或排序键 (SORTKEY) 的列。

您不能使用 ALTER TABLE ADD COLUMN 命令修改以下表和列属性：

  • UNIQUE

  • PRIMARY KEY

  • REFERENCES（外键）

  • IDENTITY 或 GENERATED BY DEFAULT AS IDENTITY

列名称的最大长度为 127 个字节；更长的名称将被截断为 127 个字节。可在单个表中定义的列的最大数目为 1,600。

在将列添加到外部表时，会应用以下限制：

  • 您无法向列约束为 DEFAULT、ENCODE、NOT NULL 或 NULL 的外部表中添加列。

  • 您无法向使用 AVRO 文件格式定义的外部表中添加列。

  • 如果启用 pseudocolumns，则可在单个表中定义的最大列数为 1,598。如果未启用 pseudocolumns，则可在单个表中定义的最大列数为 1600。

有关更多信息，请参阅CREATE EXTERNAL TABLE。

column_type

要添加的列的数据类型。对于 CHAR 和 VARCHAR 列，您可以使用 MAX 关键字而不是声明最大长度。MAX 将最大长度设置为 4096 字节（对于 CHAR）或 65535 字节（对于 VARCHAR）。GEOMETRY 对象的最大大小为 1048447 字节。

Amazon Redshift 支持以下数据类型：

  • SMALLINT (INT2)

  • INTEGER (INT, INT4)

  • BIGINT (INT8)

  • DECIMAL (NUMERIC)

  • REAL (FLOAT4)

  • DOUBLE PRECISION (FLOAT8)

  • BOOLEAN (BOOL)

  • CHAR (CHARACTER)

  • VARCHAR (CHARACTER VARYING)

  • DATE

  • TIMESTAMP

  • GEOMETRY

DEFAULT default_expr

用于为列分配默认数据值的子句。default_expr 的数据类型必须匹配列的数据类型。DEFAULT 值必须是无变量的表达式。不允许子查询、对当前表中其他列的交叉引用和用户定义的函数。

default_expr 在未为列指定值的任何 INSERT 操作中使用。如果未指定默认值，则列的默认值为 null。

如果 COPY 操作在具有 DEFAULT 值和 NOT NULL 约束的列上遇到空字段，则 COPY 命令将插入 default_expr 值。

外部表不支持 DEFAULT。

ENCODE encoding

列的压缩编码。如果未选择压缩，Amazon Redshift 会自动分配压缩编码，如下所示：

  • 默认情况下，会为临时表中的所有列分配 RAW 压缩。

  • 为定义为排序键的列分配 RAW 压缩。

  • 为定义为 BOOLEAN、REAL、DOUBLE PRECISION 或 GEOMETRY 数据类型的列分配 RAW 压缩。

  • 定义为 SMALLINT、INTEGER、BIGINT、DECIMAL、DATE、TIMESTAMP 或 TIMESTAMPTZ 的列分配了 AZ64 压缩。

  • 定义为 CHAR 或 VARCHAR 的列分配了 LZO 压缩。

注意

如果您不希望压缩某个列，请显式指定 RAW 编码。

支持以下压缩编码：

  • AZ64

  • BYTEDICT

  • DELTA

  • DELTA32K

  • LZO

  • MOSTLY8

  • MOSTLY16

  • MOSTLY32

  • RAW（无压缩）

  • RUNLENGTH

  • TEXT255

  • TEXT32K

  • ZSTD

外部表不支持 ENCODE。

NOT NULL | NULL

NOT NULL 指定列中不允许包含 null 值。NULL（默认值）指定列接受 null 值。

外部表不支持 NOT NULL 和 NULL。

DROP [ COLUMN ] column_name

要从表中删除的列的名称。

您无法删除表中的最后一列。表必须有至少一列。

您无法删除用作表的分配键 (DISTKEY) 或排序键 (SORTKEY) 的列。如果列具有任何从属对象，例如视图、主键、外键或 UNIQUE 限制，则 DROP COLUMN 的默认行为是 RESTRICT。

对外部表中的列执行 DROP 时，会应用以下限制：

  • 如果列用作分区，则您无法哦那个外部表中删除列。

  • 您无法从使用 AVRO 文件格式定义的外部表中删除列。

  • 对于外部表，将会忽略 RESTRICT 和 CASCADE。

有关更多信息，请参阅CREATE EXTERNAL TABLE。

RESTRICT

在下面这些情况下，与 DROP COLUMN 一起使用时，RESTRICT 表示不删除要删除的列：

  • 定义的视图引用了要删除的列

  • 外键引用了该列

  • 该列参与了多部分键

RESTRICT 不能与 CASCADE 一起使用。

对于外部表，将会忽略 RESTRICT 和 CASCADE。

CASCADE

在与 DROP COLUMN 配合使用时，删除指定的列以及依赖该列的任何内容。CASCADE 不能与 RESTRICT 一起使用。

对于外部表，将会忽略 RESTRICT 和 CASCADE。

以下选项仅适用于外部表。

SET LOCATION { 's3://bucket/folder/' | 's3://bucket/manifest_file' }

包含数据文件的 Amazon S3 文件夹的路径或包含 Amazon S3 对象路径列表的清单文件。存储桶必须与 Amazon Redshift 集群位于同一 AWS 区域。有关受支持的 AWS 区域的列表，请参阅Amazon Redshift Spectrum 注意事项。有关使用清单文件的更多信息，请参阅 CREATE EXTERNAL TABLE 参数 参考中的 LOCATION。

SET FILE FORMAT format

外部数据文件的文件格式。

有效格式如下所示：

  • AVRO

  • PARQUET

  • RCFILE

  • SEQUENCEFILE

  • TEXTFILE

SET TABLE PROPERTIES ( 'property_name'='property_value')

一个子句，用于设置外部表的表属性的表定义。

注意

表属性区分大小写。

'numRows'='row_count'

用于为表定义设置 numRows 值的属性。要明确更新外部表的统计数据，请设置 numRows 属性来指示表的大小。Amazon Redshift 不分析外部表来生成表统计数据，查询优化程序会使用这些统计数据来生成查询计划。如果没有为外部表设置表统计数据，则 Amazon Redshift 会生成查询执行计划。此计划是基于“外部表较大，本地表较小”的假设生成的。

'skip.header.line.count'='line_count'

用于设置在每个源文件开头要跳过的行数的属性。

PARTITION ( partition_column=partition_value [, ...] SET LOCATION { 's3://bucket/folder' | 's3://bucket/manifest_file' }

用于为一个或多个分区列设置新位置的子句。

ADD [ IF NOT EXISTS ] PARTITION ( partition_column=partition_value [, ...] ) LOCATION { 's3://bucket/folder' | 's3://bucket/manifest_file' } [, ... ]

用于添加一个或多个分区的子句。您可以使用单个 ALTER TABLE … ADD 语句指定多个 PARTITION 子句。

注意

如果使用 AWS Glue 目录，则可以使用单个 ALTER TABLE 语句最多添加 100 个分区。

IF NOT EXISTS 子句指示，如果指定的分区已存在，命令应不进行任何更改。它还指示该命令应返回分区存在的消息，而不是以错误终止。此子句在编写脚本时很有用，可使脚本在 ALTER TABLE 尝试添加已存在的分区时不会失败。

DROP PARTITION (partition_column=partition_value [, ...] )

用于删除指定分区的子句。删除分区只会更改外部表元数据。Amazon S3 上的数据不受影响。