支持的版本:当前 (17) / 16 / 15 / 14 / 13
开发版本:devel
不支持的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3

5.7. 修改表 #

当您创建表并意识到自己犯了错误,或者应用程序的需求发生变化时,您可以删除该表并重新创建它。但是,如果该表已经填充了数据,或者该表被其他数据库对象(例如外键约束)引用,则这不是一个方便的选择。因此,PostgreSQL 提供了一系列命令来修改现有表。请注意,这在概念上与更改表中包含的数据不同:这里我们感兴趣的是更改表的定义或结构。

您可以

  • 添加列

  • 删除列

  • 添加约束

  • 删除约束

  • 更改默认值

  • 更改列数据类型

  • 重命名列

  • 重命名表

所有这些操作都是使用 ALTER TABLE 命令执行的,其参考页面包含此处未提供的详细信息。

5.7.1. 添加列 #

要添加列,请使用如下命令

ALTER TABLE products ADD COLUMN description text;

新列最初填充给定的任何默认值(如果您没有指定 DEFAULT 子句,则为 null)。

提示

PostgreSQL 11 开始,添加具有常量默认值的列不再意味着在执行 ALTER TABLE 语句时需要更新表的每一行。相反,默认值将在下次访问该行时返回,并在重写表时应用,这使得 ALTER TABLE 即使在大型表上也变得非常快。

但是,如果默认值是易变的(例如,clock_timestamp()),则每一行都需要使用执行 ALTER TABLE 时计算的值进行更新。为了避免可能耗时的更新操作,特别是如果您打算无论如何都使用大多非默认值填充列,最好添加没有默认值的列,使用 UPDATE 插入正确的值,然后添加如下所述的任何所需的默认值。

您还可以使用通常的语法同时定义列上的约束

ALTER TABLE products ADD COLUMN description text CHECK (description <> '');

事实上,可以在 CREATE TABLE 中应用于列描述的所有选项都可以在这里使用。但请记住,默认值必须满足给定的约束,否则 ADD 将失败。或者,您可以在正确填充新列后稍后添加约束(见下文)。

5.7.2. 删除列 #

要删除列,请使用如下命令

ALTER TABLE products DROP COLUMN description;

列中的任何数据都会消失。涉及该列的表约束也会被删除。但是,如果该列被另一个表的外键约束引用,则 PostgreSQL 不会默默地删除该约束。您可以通过添加 CASCADE 来授权删除依赖该列的所有内容

ALTER TABLE products DROP COLUMN description CASCADE;

有关此背后的一般机制的说明,请参见第 5.15 节

5.7.3. 添加约束 #

要添加约束,请使用表约束语法。例如

ALTER TABLE products ADD CHECK (name <> '');
ALTER TABLE products ADD CONSTRAINT some_name UNIQUE (product_no);
ALTER TABLE products ADD FOREIGN KEY (product_group_id) REFERENCES product_groups;

要添加非空约束(不能写成表约束),请使用以下语法

ALTER TABLE products ALTER COLUMN product_no SET NOT NULL;

约束将立即检查,因此表数据必须在添加约束之前满足该约束。

5.7.4. 删除约束 #

要删除约束,您需要知道其名称。如果您给它一个名称,那么这很容易。否则,系统会分配一个生成的名称,您需要找出该名称。psql 命令 \d tablename 在这里可能很有用;其他界面也可能提供一种检查表详细信息的方法。然后该命令是

ALTER TABLE products DROP CONSTRAINT some_name;

(如果您正在处理像 $2 这样的生成的约束名称,请不要忘记您需要用双引号将其引起来,使其成为有效的标识符。)

与删除列一样,如果要删除依赖于其他内容的约束,则需要添加 CASCADE。一个例子是,外键约束依赖于被引用列上的唯一或主键约束。

这对于除非空约束之外的所有约束类型都适用。要删除非空约束,请使用

ALTER TABLE products ALTER COLUMN product_no DROP NOT NULL;

(请记住,非空约束没有名称。)

5.7.5. 更改列的默认值 #

要为列设置新的默认值,请使用如下命令

ALTER TABLE products ALTER COLUMN price SET DEFAULT 7.77;

请注意,这不会影响表中任何现有的行,它只会更改未来 INSERT 命令的默认值。

要删除任何默认值,请使用

ALTER TABLE products ALTER COLUMN price DROP DEFAULT;

这实际上与将默认值设置为 null 相同。因此,删除未定义默认值的默认值不是错误,因为默认值隐式为 null 值。

5.7.6. 更改列的数据类型 #

要将列转换为不同的数据类型,请使用如下命令

ALTER TABLE products ALTER COLUMN price TYPE numeric(10,2);

只有当列中的每个现有条目都可以通过隐式转换转换为新类型时,此操作才会成功。如果需要更复杂的转换,您可以添加一个 USING 子句,该子句指定如何从旧值计算新值。

PostgreSQL 将尝试将列的默认值(如果有)以及任何涉及该列的约束转换为新类型。但是这些转换可能会失败,或者可能会产生令人惊讶的结果。通常,最好在更改列的类型之前删除该列上的任何约束,然后在之后添加回适当修改的约束。

5.7.7. 重命名列 #

要重命名列

ALTER TABLE products RENAME COLUMN product_no TO product_number;

5.7.8. 重命名表 #

要重命名表

ALTER TABLE products RENAME TO items;

提交更正

如果您在文档中看到任何不正确、与您对特定功能的体验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。