此形式使用与 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。（只有在构建 PostgreSQL 时使用了 --with-lz4，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。这需要进行完整的表扫描以验证列是否不包含任何 null 值。在所有其他情况下，这是一个快速操作。

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

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

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

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

此表单验证先前创建为 NOT VALID 的外键或检查约束，方法是扫描表以确保没有不满足约束的行。如果约束已标记为有效，则不会发生任何事情。（有关此命令有用性的说明，请参阅下面的 注释。）

此命令获取 SHARE UPDATE EXCLUSIVE 锁。

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

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

触发器触发机制还受配置变量 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 形式更改表（或索引、序列、视图、物化视图或外部表）的名称、表中单个列的名称或表的约束的名称。当重命名具有基础索引的约束时，索引也会被重命名。存储的数据不受影响。

此形式将表移动到另一个模式。与表列关联的索引、约束和序列也会被移动。

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

使用 FOR VALUES 的分区使用与 CREATE TABLE 相同的 partition_bound_spec 语法。分区边界规范必须与目标表的分区策略和分区键相对应。要附加的表必须具有与目标表相同的所有列，且不能多于；此外，列类型也必须匹配。此外，它必须具有目标表的所有 NOT NULL 和 CHECK 约束，且未标记为 NO INHERIT。目前，不考虑 FOREIGN KEY 约束。如果父表中不存在 UNIQUE 和 PRIMARY KEY 约束，则会在分区中创建这些约束。

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

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

当表具有默认分区时，定义新分区会更改默认分区分区约束。默认分区不能包含任何需要移动到新分区的行，并且会扫描以验证是否不存在任何此类行。如果存在适当的 CHECK 约束，则可以避免此扫描，就像新分区的扫描一样。同样，当默认分区是外部表时，始终会跳过此扫描。

附加分区会在父表上获取 SHARE UPDATE EXCLUSIVE 锁，此外还在要附加的表和默认分区（如果有）上获取 ACCESS EXCLUSIVE 锁。

如果要附加的表本身是分区表，则还必须在所有子分区上持有进一步的锁。同样，如果默认分区本身是分区表。可以通过添加 第 5.12.2.2 节中所述的 CHECK 约束来避免子分区的锁定。

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

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

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

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

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

新列或现有列的名称。

现有列的新名称。

表的新名称。

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

表的新表约束。

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

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

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

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

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

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

现有索引的名称。

表存储参数的名称。

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

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

表的新所有者的用户名。

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

表将移动到的表空间的名称。

表将移动到的模式的名称。

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

新分区的分区边界规范。 有关相同语法的更多详细信息，请参阅 CREATE TABLE。