此形式使用与 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 之间设置。将其设置为 DEFAULT 将恢复为使用系统默认的统计信息目标 (default_statistics_target)。（设置为 -1 是一个过时的拼写方式，可以得到相同的结果。）有关 PostgreSQL 查询计划程序如何使用统计信息的更多信息，请参阅 第 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 查询计划程序如何使用统计信息的更多信息，请参阅 第 14.2 节。

更改每个属性选项会获取 SHARE UPDATE EXCLUSIVE 锁。

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

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

此形式使用与 CREATE TABLE 相同的约束语法，再加上 NOT VALID 选项，将新的约束添加到表中，该选项目前仅允许用于外键和 CHECK 约束。

通常，此形式将导致扫描表以验证表中所有现有行是否都满足新约束。 但是，如果使用 NOT VALID 选项，则会跳过此可能很长的扫描。 该约束仍然会在后续插入或更新时执行（也就是说，它们将失败，除非在引用的表中存在匹配的行，对于外键而言，或者它们将失败，除非新行匹配指定的检查条件）。 但是，数据库不会假设该约束对表中的所有行都成立，直到使用 VALIDATE CONSTRAINT 选项对其进行验证。 有关使用 NOT VALID 选项的更多信息，请参见下面的 说明。

尽管大多数形式的 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。 这需要完全扫描表以验证列(s) 不包含空值。 在所有其他情况下，这是一个快速操作。

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

执行此命令后，索引将被约束 “拥有”，就像索引是由常规 ADD PRIMARY KEY 或 ADD UNIQUE 命令构建的一样。 特别是，删除约束将使索引也消失。

此形式目前不支持分区表。

此形式更改先前创建的约束的属性。 目前，只有外键约束可以被更改。

此形式通过扫描表以确保没有不满足约束的行，来验证先前创建为 NOT VALID 的外键或检查约束。 如果约束已标记为有效，则不会发生任何事情。 (有关此命令用处的说明，请参见下面的 说明。)

此命令获取 SHARE UPDATE EXCLUSIVE 锁。

此形式删除表上指定的约束，以及任何作为约束基础的索引。 如果指定了 IF EXISTS 并且约束不存在，则不会引发错误。 在这种情况下，将发出通知。

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

触发器触发机制还会受到配置变量 session_replication_role 的影响。 仅启用的触发器（默认值）将在复制角色为 “origin”（默认值）或 “local” 时触发。 配置为 ENABLE REPLICA 的触发器仅在会话处于 “replica” 模式时才会触发，而配置为 ENABLE ALWAYS 的触发器则会始终触发，而不管当前的复制角色是什么。

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

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

此命令获取 SHARE ROW EXCLUSIVE 锁。

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

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

这些形式控制属于表的行级安全策略的应用。 如果启用并且表中不存在任何策略，那么将应用默认拒绝策略。 请注意，即使行级安全被禁用，策略也可能存在于表中。 在这种情况下，策略将 不会 被应用，并且策略将被忽略。 另请参见 CREATE POLICY。

这些形式控制当用户是表所有者时属于表的行级安全策略的应用。 如果启用，当用户是表所有者时，行级安全策略将被应用。 如果禁用（默认值），那么当用户是表所有者时，行级安全将不被应用。 另请参见 CREATE POLICY。

此形式选择未来 CLUSTER 操作的默认索引。它不会真正地重新聚类表。

更改集群选项将获取 SHARE UPDATE EXCLUSIVE 锁。

此形式从表中删除最近使用的 CLUSTER 索引规范。这会影响未来没有指定索引的集群操作。

更改集群选项将获取 SHARE UPDATE EXCLUSIVE 锁。

用于删除 oid 系统列的向后兼容语法。由于 oid 系统列不再可以添加，因此此操作永远不会生效。

此形式通过使用指示的访问方法重写表来更改表的访问方法；指定 DEFAULT 将选择设置为 default_table_access_method 配置参数的访问方法。有关更多信息，请参阅 第 61 章。

当应用于分区表时，没有数据需要重写，但之后创建的分区将默认使用给定的访问方法，除非被 USING 子句覆盖。指定 DEFAULT 会删除以前的值，导致未来的分区默认使用 default_table_access_method。

此形式将表的表空间更改为指定的表空间，并将与表关联的数据文件移动到新表空间。表上的索引（如果有）不会移动；但它们可以通过额外的 SET TABLESPACE 命令单独移动。当应用于分区表时，不会移动任何内容，但之后使用 CREATE TABLE PARTITION OF 创建的任何分区将使用该表空间，除非被 TABLESPACE 子句覆盖。

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

此形式将表从非日志化更改为日志化或反之亦然（请参阅 UNLOGGED）。它不能应用于临时表。

这还会更改与表关联的任何序列（对于标识或序列列）的持久性。但是，也可以分别更改此类序列的持久性。

此形式更改表的一个或多个存储参数。有关可用参数的详细信息，请参阅 CREATE TABLE 文档中的 存储参数。请注意，此命令不会立即修改表内容；根据您选择的参数，您可能需要重写表才能获得所需的效果。这可以通过 VACUUM FULL、CLUSTER 或强制表重写的 ALTER TABLE 的形式之一来完成。对于与规划程序相关的参数，更改将在下次锁定表时生效，因此当前正在执行的查询不会受到影响。

将为 fillfactor、toast 和 autovacuum 存储参数以及规划程序参数 parallel_workers 获取 SHARE UPDATE EXCLUSIVE 锁。

此形式将一个或多个存储参数重置为其默认值。与 SET 一样，可能需要重写表才能完全更新表。

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

对于父表的所有 CHECK 约束，也必须有匹配的子表约束，除了在父表中标记为不可继承（即使用 ALTER TABLE ... ADD CONSTRAINT ... NO INHERIT 创建）的那些约束，这些约束将被忽略；所有匹配的子表约束不能标记为不可继承。当前 UNIQUE、PRIMARY KEY 和 FOREIGN KEY 约束不被考虑，但这在将来可能会改变。

此形式从指定父表的子表列表中删除目标表。针对父表的查询将不再包含从目标表中提取的记录。

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

此形式使类型化表与其类型分离。

此形式将表、序列、视图、物化视图或外部表的拥有者更改为指定的用戶。

此形式更改写入预写日志的信息，以标识已更新或删除的行。在大多数情况下，只有当每个列的旧值不同于新值时才记录旧值；但是，如果旧值存储在外部，则无论它是否更改，都会始终记录它。此选项除了逻辑复制使用时之外没有其他作用。

RENAME 形式更改表（或索引、序列、视图、物化视图或外部表）的名称、表中单个列的名称或表中约束的名称。当重命名具有底层索引的约束时，索引也会被重命名。对存储的数据没有影响。

此形式将表移到另一个模式中。相关的索引、约束和表列拥有的序列也将被移动。

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

使用 FOR VALUES 的 partition 使用与 CREATE TABLE 相同的语法用于 partition_bound_spec。partition 边界规范必须对应于目标表的 partition 策略和 partition key。要附加的表必须具有与目标表相同的所有列，不得有更多列；此外，列类型也必须匹配。此外，它必须具有目标表的所有 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 约束来避免对子分区的锁定，如 第 5.12.2.2 节 中所述。

此形式会分离目标表的指定分区。分离的分区将继续作为独立表存在，但不再与从中分离的表有任何联系。任何附加到目标表索引的索引都将被分离。任何作为目标表中索引的克隆创建的触发器都将被删除。对于在外部键约束中引用此分区表的任何表，将获得 SHARE 锁。

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

如果指定了 FINALIZE，则会完成先前被取消或中断的 DETACH CONCURRENTLY 调用。一次只能有一个分区在分区表中处于待分离状态。

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

要更改的现有表的名称（可选地限定模式）。如果在表名前面指定了 ONLY，则只更改该表。如果没有指定 ONLY，则会更改该表及其所有后代表（如果有）。可选地，可以在表名后面指定 * 来明确指示包含后代表。

新列或现有列的名称。

现有列的新名称。

表的新名称。

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

表的新表约束。

新约束或现有约束的名称。

自动删除依赖于被删除的列或约束的对象（例如，引用该列的视图），以及依次删除依赖于这些对象的 所有对象（参见 第 5.15 节）。

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

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

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

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

现有索引的名称。

表存储参数的名称。

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

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

表的新的所有者的用户名。

将要转换为该表的访问方法的名称。

将要移动该表的表空间的名称。

将要移动该表的模式的名称。

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

新分区的分区边界规范。有关相同语法的信息，请参见 CREATE TABLE。