Postgresql 中文操作指南

此表单使用与 CREATE TABLE 相同的语法向表添加新列。如果指定了 IF NOT EXISTS 并且已经存在具有此名称的列，则不会引发错误。

此表单从表中删除列。涉及该列的索引和表约束也将自动删除。如果删除列将导致统计信息仅包含单个列的数据，则也会删除引用已删除列的多变量统计信息。如果表外的任何内容（例如外键引用或视图）依赖于该列，则需要声明 CASCADE 。如果指定了 IF EXISTS 并且该列不存在，则不会引发错误。在这种情况下，将发出通知。

此表单更改表中列的类型。涉及该列的索引和简单表约束将自动重新解析最初提供的表达式以使用新列类型进行转换。可选的 COLLATE 子句为新列指定排序规则；如果省略，则排序规则是新列类型的默认值。可选的 USING 子句指定如何根据旧值计算新列值；如果省略，则默认转换与从旧数据类型到新数据类型的赋值强制转换相同。如果从旧类型到新类型没有隐式或赋值强制转换，则必须提供一个 USING 子句。

当使用此表单时，列的统计信息将被删除，因此建议之后针对该表运行 ANALYZE 。

这些表单设置或移除列的默认值（其中移除等同于将默认值设置为 NULL）。新的默认值仅适用于后续的 INSERT 或 UPDATE 命令；它不会导致表中已有的行发生更改。

这些表单更改列是否标记为允许空值或拒绝空值。

SET NOT NULL 仅可应用于表中记录都不包含该列的 NULL 值的列。通常，这是通过扫描整个表在 ALTER TABLE 期间检查的；但是，如果找到了一个有效的 CHECK 约束，证明 NULL 不可能存在，那么将跳过表扫描。

如果此表是一个分区，如果它在父表中被标记为 NOT NULL ，则无法对该列执行 DROP NOT NULL 。要从所有分区中删除 NOT NULL 约束，请针对父表执行 DROP NOT NULL 。即使父级没有 NOT NULL 约束，如果需要，仍然可以将此类约束添加到各个分区；也就是说，即使父级允许空值，子级也可以禁止空值，但反之则不然。

此表单将存储的生成列转换为正常的基本列。保留列中的现有数据，但以后的更改将不再应用生成表达式。

如果指定了 DROP EXPRESSION IF EXISTS 并且该列不是存储的生成列，则不会引发错误。在这种情况下，将发出通知。

这些表单更改列是否是标识列或更改现有标识列的生成属性。有关详细信息，请参阅 CREATE TABLE 。与 SET DEFAULT 一样，这些表单仅影响后续 INSERT 和 UPDATE 命令的行为；它们不会导致表中已有的行发生更改。

如果指定了 DROP IDENTITY IF EXISTS 并且该列不是标识列，则不会引发错误。在这种情况下，将发出通知。

这些形式更改用于现有标识列的基础序列。 sequence_option 是 ALTER SEQUENCE 支持的选项，例如 INCREMENT BY 。

此形式将每列统计信息收集目标设置为后续 ANALYZE 操作。目标可在 0 到 10000 范围内设置；或者，将其设置为 -1 以恢复到使用系统默认统计目标 ( default_statistics_target )。有关 PostgreSQL 查询计划程序如何使用统计信息，请参见 Section 14.2 。

SET STATISTICS 获取 SHARE UPDATE EXCLUSIVE 锁。

此形式设置或重置每属性选项。目前，唯一定义的每一属性选项为 n_distinct 和 n_distinct_inherited ，它们将覆盖后续 ANALYZE 操作进行的不同值的估算次数。 n_distinct 影响表本身的统计，而 n_distinct_inherited 影响收集到的表的统计，以及它的继承子集。当设置为正值时， ANALYZE 将假定该列恰好包含指定数量的不同非空值。当设置为负值时（必须大于或等于 -1）， ANALYZE 将假定该列中不同非空值的数字呈线性分布于表格大小；确切计数方法是将估计表大小乘以所给数字的绝对值。例如，-1 的值意味着该列中的所有值都不同，而 -0.5 的值意味着每个值平均出现两次。这一点很有用，因为随着时间的推移，表格的大小在不断变化，而乘以表格中的行数是在查询计划时间执行的。将值指定为 0 以恢复为正常估算不同值。有关 PostgreSQL 查询计划程序如何使用统计信息，请参见 Section 14.2 。

更改每属性选项需要获得 SHARE UPDATE EXCLUSIVE 锁。

此形式为列设置存储方式。它控制此列是内联持有还是在辅助的 TOAST 表中持有，以及数据是否应该压缩。 PLAIN 必须用于定长值，如 integer ，并且是内联的且未压缩的。 MAIN 用于可压缩的内联数据。 EXTERNAL 用于外部非压缩数据，而 EXTENDED 用于外部压缩数据。写入 DEFAULT 将存储方式设置为该列数据类型的默认模式。 EXTENDED 是支持非 PLAIN 存储的大多数数据类型的默认值。 EXTERNAL 的使用将使对非常大的 text 和 bytea 值的子字符串操作运行得更快，但代价是牺牲存储空间。请注意， ALTER TABLE …​ SET STORAGE 本身不会更改表中的任何内容；它只是设置在未来表更新期间预期执行的策略。请参见 Section 73.2 以了解更多信息。

此形式为列设置压缩方法，用于确定未来插入的值将如何压缩（如果存储方式允许压缩的话）。这不会导致表格被重写，所以现有数据仍然可用其他压缩方法压缩。如果使用 pg_restore 恢复该表格，那么所有值将使用配置的压缩方法重写。然而，当从另一个关系（例如，由 INSERT …​ SELECT ）插入数据时，源表格中的值不一定会解压缩，所以任何之前压缩的数据可能会保留其已有的压缩方法，而不是使用目标列的压缩方法重新压缩。支持的压缩方法包括 pglz 和 lz4 。( lz4 仅在 PostgreSQL 构建时使用 —​with-lz4 时可用。)此外， compression_method 可以为 default ，它将在数据插入时咨询 default_toast_compression 设置，以选择要使用的方法。

此形式使用与 CREATE TABLE 相同约束语法的约束为表添加新约束，加上选项 NOT VALID ，它目前仅允许用于外键和检查约束。

通常情况下，此形式将在表中进行扫描，以验证表中所有现有行均满足新约束。但是，如果使用了 NOT VALID 选项，则会跳过此可能很长的扫描。对于后续插入或更新，仍将使用约束（也就是说，在这种情况下插入或更新会失败，除非在所引用的表中有一行匹配，或者除非新行与指定的检查条件匹配）。但是，在通过使用 NOT VALID 选项对其进行验证之前，数据库不会假定此约束对表中的所有行有效。有关如何使用 NOT VALID 选项的详细信息，请参见下面的 Notes 。

尽管 ADD _table_constraint_ 的大多数形式需要 ACCESS EXCLUSIVE 锁，但 ADD FOREIGN KEY 只需要 SHARE ROW EXCLUSIVE 锁。请注意，除了在声明约束的表的锁之外， ADD FOREIGN KEY 还将在所引用的表上获取 SHARE ROW EXCLUSIVE 锁。

将唯一或主键约束添加到分区表时应用其他限制；请参见 CREATE TABLE 。此外，当前不能将分区表的外键约束声明为 NOT VALID 。

此形式根据现有唯一索引向表添加 PRIMARY KEY 或 UNIQUE 约束。索引的所有列都将包含在约束中。

该索引不能包含表达式列，也不能是部分索引。此外，它必须是具有默认排序顺序的 b 树索引。这些限制可确保索引等同于通过常规 ADD PRIMARY KEY 或 ADD UNIQUE 命令建立的索引。

如果指定了 PRIMARY KEY 并且索引的列尚未标记为 NOT NULL ，那么此命令将尝试对此类每一列执行 ALTER COLUMN SET NOT NULL 。需要对表执行完全扫描，以验证各列是否不包含空值。在所有其他情况下，这是一项快速的操作。

如果提供了约束名称，则索引将被重命名为与约束名称匹配。否则，将为该约束命名为与索引相同的名称。

此命令执行后，该约束“拥有”该索引，这与该索引是由常规的 ADD PRIMARY KEY 或 ADD UNIQUE 命令建立的类似。尤其是，删除该约束也会使该索引消失。

此表单当前不支持分区表。

此表单更改以前创建的约束的属性。目前，只能更改外键约束。

此表单验证以前作为 NOT VALID 创建的外键或检查约束，通过扫描表来确保没有约束不满足的行。如果约束已标记为有效，则不会发生任何情况。（请参见下方的 Notes 了解此命令的有效性的解释。）

此命令获取 SHARE UPDATE EXCLUSIVE 锁。

此表单丢弃表上指定的约束，以及约束下的任何索引。如果指定了 IF EXISTS ，并且约束不存在，则不会引发错误。在这种情况下，会发出通知。

这些表单配置触发器属于表的触发。系统仍然知道已禁用的触发器，但在发生触发事件时不执行该触发器。（对于延迟触发器，在事件发生时检查启用状态，而不是在实际执行触发器函数时。）可以禁用或启用通过名称指定的单个触发器，或表上的所有触发器，或仅用户触发器（此选项不包括内部生成的约束触发器，例如用于实现外键约束或可延迟唯一性和排除约束的触发器）。禁用或启用内部生成的约束触发器需要超级用户权限；应该谨慎执行此操作，因为如果未执行触发器，当然无法保证约束的完整性。

触发器触发机制也受配置变量 session_replication_role 影响。只要启用了触发器（默认方式），当复制角色为“源”（默认方式）或“本地”时，它们将触发。配置为 ENABLE REPLICA 的触发器仅在会话处于“副本”模式下才会触发，而配置为 ENABLE ALWAYS 的触发器会触发而不考虑当前的复制角色。

此机制的影响在于，在默认配置中，触发器不会在副本上触发。这非常有用，因为如果触发器在源上用于在表之间传播数据，那么复制系统也将复制已传播的数据；因此，触发器不应该在副本上第二次触发，因为那会导致重复。但是，如果出于其他目的（例如创建外部警报）使用触发器，则可以将其设置为 ENABLE ALWAYS ，以便在副本上也触发它。

当此命令应用于分区表时，分区中相应的克隆触发器的状态也会更新，除非指定了 ONLY 。

此命令获取 SHARE ROW EXCLUSIVE 锁。

这些表单配置表中属于该表的重写规则的触发。系统仍然知道已禁用的规则，但在查询重写期间不会应用该规则。禁用/启用触发器的语义也一样。此配置对于 ON SELECT 规则将被忽略，这些规则始终应用以便在当前会话处于非默认复制角色时也能使视图正常工作。

规则触发机制也受配置变量 session_replication_role 的影响，类似于上面描述的触发器。

这些表单控制对表具有的行安全策略的应用。如果启用了，并且表没有策略存在，那么会应用默认拒绝策略。请注意，即使禁用了行级安全，对表仍然可能有策略存在。在这种情况下，策略将 not 应用，并且策略将被忽略。另请参阅 CREATE POLICY 。

当用户为表所有者时，这些表单控制对表具有的行安全策略的应用。如果启用了，则当用户为表所有者时，将应用行级安全策略。如果禁用了（默认方式），则当用户为表所有者时，行级安全不会被应用。另请参阅 CREATE POLICY 。

此表单为将来 CLUSTER 操作选择默认索引。它不会实际重新对表进行聚簇。

更改聚集选项会获取 SHARE UPDATE EXCLUSIVE 锁。

此表单从表中移除最近使用的 CLUSTER 索引规范。这会影响不指定索引的将来聚集操作。

更改聚集选项会获取 SHARE UPDATE EXCLUSIVE 锁。

用于移除 oid 系统列的向后兼容语法。由于已经不再可添加 oid 系统列，因此此表单永远不会产生效果。

此表单通过重写来更改表访问方法。有关更多信息，请参见 Chapter 63 。

此表单将表的表空间更改为指定的表空间，并将与表关联的数据文件移动到新的表空间。表上的索引（如果存在）不会被移动，但它们可以使用其他 SET TABLESPACE 命令单独移动。当应用于分区表时，不会移动任何内容，但使用 CREATE TABLE PARTITION OF 创建的任何后续分区都将使用该表空间，除非被 TABLESPACE 子句替代。

使用 ALL IN TABLESPACE 表单可以移动当前数据库中表空间中的所有表，该表单将首先锁定要移动的所有表，然后再逐一移动每个表。此表单还支持 OWNED BY ，它只会移动由指定的角色所有的表。如果指定 NOWAIT 选项，则在无法立即获取所有必需的锁时，该命令将失败。请注意，系统目录不会由此命令移动，如果需要，请改用 ALTER DATABASE 或显式 ALTER TABLE 调用。 information_schema 关系不属于系统目录的一部分，且会被移动。另请参见 CREATE TABLESPACE 。

此表单将表从未记录的更改为记录的，或反之亦然（参见 UNLOGGED ）。它不能应用于临时表。

这也更改了链接到表（对于标识列或序列列）的任何序列的持久性。但是，也有可能单独更改此类序列的持久性。

此表单更改表的存储参数（一个或多个）。有关可用参数的详细信息，请参阅 CREATE TABLE 文档中的 Storage Parameters 。请注意，此命令不会立即修改表内容；根据参数，您可能需要重写表以获得所需效果。可以使用 VACUUM FULL 、 CLUSTER 或强制表重写的其中一种 ALTER TABLE 表单来完成。对于计划程序相关的参数，更改将在下次锁定表时生效，因此不会影响当前执行的查询。

SHARE UPDATE EXCLUSIVE 针对填充因子、toast 和自动清理存储参数，以及计划程序参数 parallel_workers 获取锁。

此表单将一个或多个存储参数重置为它们的默认值。与 SET 一样，可能需要表重写来完全更新表。

此表单将目标表作为指定父表的新的子表添加。随后对父表的查询将包括目标表的记录。要添加为子表，目标表必须已包含与父表完全相同的列（它可以有额外的列）。列必须具有匹配的数据类型，并且如果它们在父表中有 NOT NULL 约束，则在子表中也必须有 NOT NULL 约束。

还必须为父表的所有 CHECK 约束提供匹配的子表约束，除了在父表中标记为不可继承的那些（即使用 ALTER TABLE …​ ADD CONSTRAINT …​ NO INHERIT 创建的）约束，它们将被忽略。所有匹配的子表约束都不得标记为不可继承。当前， UNIQUE 、 PRIMARY KEY 和 FOREIGN KEY 约束未被考虑，但这可能会在将来发生改变。

此表单从指定父表的子表列表中移除目标表。针对父表的查询将不再包括从目标表获取的记录。

此表单将表链接到复合类型中，就好像 CREATE TABLE OF 已经形成该表一样。表的列名和类型列表必须与复合类型的列名和类型列表完全匹配。表不得从任何其他表继承。这些限制确保 CREATE TABLE OF 会允许等效表定义。

此表单将键入表与其类型分离开来。

此表单将表、序列、视图、物化视图或外表的拥有者更改为指定的用户。

此表单将写入预写式日志的信息更改为识别已更新或已删除的行。在大多数情况下，每一列的旧值仅在与新值不同时才被记录；但是，如果旧值被存储在外部，它总是被记录，无论它是否被更改。只有在使用逻辑复制时，此选项才会生效。

RENAME 表单会更改表（或一个索引、序列、视图、物化视图或外表）的名称、表中各个列的名称或表的约束名称。在重命名一个有底层索引的约束时，该索引也会被重命名。这不会对存储数据产生影响。

此表单将表移动到另一个模式中。关联的索引、约束和由表列拥有序列也会一起被移动。

此表单将一个现存的表（本身可能已被分区）附加为目标表的一个分区。可以使用 FOR VALUES 将表附加为特定值的某个分区，或者使用 DEFAULT 将表附加为一个默认分区。针对目标表中的每个索引，将在附加表中创建一个相应的索引；或者，如果一个同等索引已经存在，它将被附加到目标表的索引中，就好像已经执行了 ALTER INDEX ATTACH PARTITION 。请注意，如果现有表是一个外表，则当前不允许将表附加为目标表的分区，如果目标表上有 UNIQUE 索引（另请参阅 CREATE FOREIGN TABLE ）。针对目标表中存在的每个用户定义的行级触发器，会在附加表中创建一个相应的触发器。

使用 FOR VALUES 的分区对 partition_bound_spec 使用与 CREATE TABLE 相同的语法。分区边界规范必须与分区策略和目标表的划分键相对应。要附加的表必须拥有与目标表所有相同且不更多的列；此外，列类型也必须匹配。而且，它还必须拥有目标表的所有 NOT NULL 和 CHECK 约束。当前不考虑 FOREIGN KEY 约束。父表中的 UNIQUE 和 PRIMARY KEY 约束将在分区中创建，如果它们不存在。如果要附加的表的任何 CHECK 约束被标记为 NO INHERIT ，该命令将会失败；此类约束必须在没有 NO INHERIT 子句的情况下重新创建。

如果新分区是个普通表，则会执行一个全表扫描来检查表中现有的行是否违反了分区约束。可以通过在运行此命令之前向表中添加一个允许仅具有满足所需分区约束的行一个有效的 CHECK 约束，来避免此扫描。 CHECK 约束将用来确定无需扫描表来验证分区约束。但是，如果任何分区键是一个表达式，并且分区不接受 NULL 值，则此方法将不起作用。如果附加一个将不接受 NULL 值的列表分区，除非它是一个表达式，还要向分区键列添加一个 NOT NULL 约束。

如果新分区是一个外表，则不会执行任何操作来验证外表中的所有行是否服从分区约束。（请参阅 CREATE FOREIGN TABLE 中有关外表上的约束的讨论。）

当一个表有默认分区时，定义一个新分区将更改默认分区的分区约束。默认分区不能包含任何需要移动到新分区中的行，并且将对其进行扫描以验证是否没有此类行存在。这个扫描，如新分区的扫描一样，可以在存在一个合适的 CHECK 约束时避免。同样地，就像新分区的扫描一样，当默认分区是一个外表时，它总是会被跳过。

附加一个分区将会获取父表上的一个 SHARE UPDATE EXCLUSIVE 锁以及附加表的 ACCESS EXCLUSIVE 锁（如果有默认分区），并且在该默认分区上获取一个锁。

如果要附加的表本身是一个分区表，则还必须对所有子分区保持锁定。同样，如果默认分区本身是一个分区表，也是如此。可以通过添加 CHECK 约束（如 Section 5.11.2.2 中所述），来避免锁定子分区。

此表单分离目标表的指定分区。分离的分区继续作为一个独立表存在，但不再与分离其的表有任何联系。任何附加到目标表索引的索引都被分离。任何作为目标表中索引克隆创建的触发器都会被移除。 SHARE 锁被获取到任何在外部密钥约束中引用此分区表的表中。

如果指定了 CONCURRENTLY ，它将使用一个更低级别的锁来运行，以避免阻塞可能正在访问分区表的其它会话。在此模式下，在内部会使用两个事务。在第一个事务期间， SHARE UPDATE EXCLUSIVE 锁被获取到父表和分区上，并且分区被标记为正在分离；在那时，事务被提交，并且等待所有其它使用分区表的会话。一旦所有那些事务完成，第二个事务将在分区表上获取 SHARE UPDATE EXCLUSIVE ，在分区上获取 ACCESS EXCLUSIVE ，并且分离过程完成。 CHECK 约束（复制分区约束）被添加到分区。 CONCURRENTLY 不能在事务块中运行，并且如果分区表包含默认分区，则不允许使用 CONCURRENTLY 。

如果指定了 FINALIZE ，则一个先前取消或中断的 DETACH CONCURRENTLY 调用将会完成。一次，分区表中最多只有一个分区可以挂起分离。

如果表不存在，请不要抛出错误。在此情况下，会发出通知。

要更改的现有表的名称（可以选择模式限定）。如果在表名前指定 ONLY ，则只更改该表。如果未指定 ONLY ，则更改表及其所有后代表（如果存在）。也可以在表名后指定 * ，以明确表明包含后代表。

新列或现有列的名称。

现有列的新名称。

表的名称。

新列的数据类型，或现有列的新数据类型。

表的新的表约束。

新或现有约束的名称。

自动删除依赖于已删除列或约束的对象（例如，引用该列的视图），继而删除依赖于这些对象的所有对象（请参阅 Section 5.14 ）。

如果存在任何依赖对象，则拒绝删除列或约束。这是默认行为。

要禁用或启用的单个触发器的名称。

禁用或启用属于表的全部触发器。（如果任何触发器是内部生成的约束触发器（例如，用于实现外键约束或可延迟的唯一性和排除约束的触发器），则此操作需要超级用户权限。）

禁用或启用属于表的全部触发器，但内部生成的约束触发器除外（例如，用于实现外键约束或可延迟的唯一性和排除约束的触发器）。

现有索引的名称。

表存储参数的名称。

表存储参数的新值。它可能是数字或单词，具体取决于参数。

与该表关联或取消关联的父表。

新表所有者的用户名。

将表转换成的访问方法的名称。

表将被移至的表空间的名称。

表将被移至的模式的名称。

作为新分区附加或从此表分离的表的名称。

新分区的分区绑定规范。请参阅 CREATE TABLE ，以了解更多关于其语法的详细信息。