toast.vacuum_truncate

说明

vacuum_truncate 参数的每表取值。若 VACUUM 指定了 TRUNCATE 参数，将覆盖此选项的值。

适用对象

TOAST 表

取值类型

布尔值

用法

WITH (toast.vacuum_truncate = value)

TOAST 参数的继承

该选项控制主表附属的 TOAST 表。在主表的 WITH 或 ALTER TABLE SET 子句中使用 toast. 前缀设置；若未设置对应的 TOAST 选项，而主表已设置同名选项，TOAST 表会使用主表的值。

下列手册说明同时介绍主表与 TOAST 形式。自动 ANALYZE 不适用于 TOAST 表；此目录仅展开该版本手册明确列出的 toast. 选项。

表存储参数的共同规则

WITH 子句可以为表以及与 UNIQUE、 PRIMARY KEY 或 EXCLUDE 约束关联的索引指定 存储参数。索引的存储参数已在 CREATE INDEX 中介绍。当前可用于表的存储参数列在下文。对于其中许多参数，如下所示，还存在一个同名且带 toast. 前缀的附加参数，用于控制该表的二级 TOAST 表（如果有）的行为（更多有关 TOAST 的信息见 第 66.2 节）。如果设置了表参数值，而对应的 toast. 参数未设置，则 TOAST 表将使用该表的参数值。不支持为分区表指定这些参数，但可以为单独的叶子分区指定。

物化视图

该子句为新物化视图指定可选的存储参数；更多信息见 CREATE TABLE 文档中的 Storage Parameters。凡是 CREATE TABLE 支持的参数， CREATE MATERIALIZED VIEW 也同样支持。另见 CREATE TABLE。

对应全局参数：vacuum_truncate

以下为该版本全局参数的说明，用于理解作用与单位。文中全局默认值、可设置位置和生效方式属于 GUC；关系选项的覆盖规则仍以上面的关系级说明为准。

启用或禁用 vacuum 尝试截断表末尾的空页。默认值为 true。如果为 true，则 VACUUM 和 autovacuum 会执行截断，并将这些页面占用的磁盘空间返还给操作系统。请注意，截断需要获取表上的 ACCESS EXCLUSIVE 锁。如果在 VACUUM 中指定了 TRUNCATE 参数，它将覆盖该参数的值。也可以通过修改表存储参数来为单个表覆盖此设置。

相关条目

• 主表参数 vacuum_truncate
• 全局参数 vacuum_truncate
• CREATE TABLE

文档与源码

• PostgreSQL 18 中文手册
• 对应全局参数：vacuum_truncate
• PostgreSQL 18 中文手册

同类条目

• toast.autovacuum_enabledTOAST 启用自动清理
• toast.autovacuum_freeze_max_ageTOAST 事务 ID 强制冻结年龄
• toast.autovacuum_freeze_min_ageTOAST 事务 ID 最小冻结年龄
• toast.autovacuum_freeze_table_ageTOAST 事务 ID 全表冻结年龄
• toast.autovacuum_multixact_freeze_max_ageTOAST 多事务 ID 强制冻结年龄
• toast.autovacuum_multixact_freeze_min_ageTOAST 多事务 ID 最小冻结年龄
• toast.autovacuum_multixact_freeze_table_ageTOAST 多事务 ID 全表冻结年龄
• toast.autovacuum_vacuum_cost_delayTOAST 自动清理代价延迟
• toast.autovacuum_vacuum_cost_limitTOAST 自动清理代价上限
• toast.autovacuum_vacuum_insert_scale_factorTOAST 插入触发清理比例因子
• toast.autovacuum_vacuum_insert_thresholdTOAST 插入触发清理基础阈值
• toast.autovacuum_vacuum_max_thresholdTOAST 自动清理阈值上限