PostgreSQL 文档检索

TOAST章节正文PG1866.2. TOAST 本节概述超长属性存储技术（TOAST, The Oversized-Attribute Storage Technique）。PostgreSQL 使用固定页面大小（通常为 8 kB），并且不允许元组跨越多个页面。因此，无法直接存储非常大的字段值。为克服这一限制，大字段值会被压缩并且/或者拆分成多个物理行。这个过程对用户是透明的，而且对大部分后端代码的影…TOAST toast扩展与模块扩展目录教程7 TOAST Tutorial 7 TOAST toast 管理运维管理运维 · 扩展目录 TOAST 注意事项章节正文PG1836.13.1. TOAST 注意事项如果你的数据类型的值在内部形式上的大小可变，通常最好让该数据类型支持 TOAST（见第 66.2 节）。即使这些值总是小到不需要压缩或行外存储，也应该这样做，因为 TOAST 还可以通过减少头部开销来为小数据节省空间。为了支持 TOAST 存储，操作该数据类型的 C 级函数必须始终使用 PG_DETOAST_DATUM 小心地对传给它们的任…TOAST 注意事项 toast.autovacuum_enabled存储参数本站词条对 TOAST 表单独设置。控制当前关系的常规自动清理；关闭后仍不能阻止防止事务 ID 回卷所需的清理。 TOAST 启用自动清理 TOAST 表 为特定表启用或禁用自动清理守护进程。如果为真，自动清理守护进程将按照 第 24.1.6 节 中讨论的规则，在该表上执行自动 VACUUM 和/或 ANALYZE 操作。如果为假，则该表不会被自动清理，但为了防止事务 ID 回卷，仍可…存储参数 · TOAST 表 toast.autovacuum_freeze_max_age存储参数本站词条对 TOAST 表单独设置。为当前关系降低触发防事务 ID 回卷自动清理的年龄上限。 TOAST 事务 ID 强制冻结年龄 TOAST 表 autovacuum_freeze_max_age 参数的每表取值。注意，自动清理会忽略大于系统范围设置的每表 autovacuum_freeze_max_age 参数（它只能设置得更小）。 WITH (toast.autovacuum_f…存储参数 · TOAST 表 toast.autovacuum_freeze_min_age存储参数本站词条对 TOAST 表单独设置。为当前关系设置普通清理开始冻结事务 ID 的最小年龄。 TOAST 事务 ID 最小冻结年龄 TOAST 表 vacuum_freeze_min_age 参数的每表取值。注意，自动清理会忽略大于系统范围 autovacuum_freeze_max_age 设置一半的每表 autovacuum_freeze_min_age 参数。 WITH (toas…存储参数 · TOAST 表 toast.autovacuum_freeze_table_age存储参数本站词条对 TOAST 表单独设置。为当前关系设置触发积极冻结扫描的事务 ID 年龄阈值。 TOAST 事务 ID 全表冻结年龄 TOAST 表 vacuum_freeze_table_age 参数的每表取值。 WITH (toast.autovacuum_freeze_table_age = value) 适用对象 TOAST 表 取值类型 整数 TOAST 参数的继承 该选项控制…存储参数 · TOAST 表 toast.autovacuum_multixact_freeze_max_age存储参数本站词条对 TOAST 表单独设置。为当前关系降低触发防多事务 ID 回卷自动清理的年龄上限。 TOAST 多事务 ID 强制冻结年龄 TOAST 表 autovacuum_multixact_freeze_max_age 参数的每表取值。注意，自动清理会忽略大于系统范围设置的每表 autovacuum_multixact_freeze_max_age 参数（它只能设置得更小）。 WI…存储参数 · TOAST 表 toast.autovacuum_multixact_freeze_min_age存储参数本站词条对 TOAST 表单独设置。为当前关系设置清理时替换多事务 ID 的最小年龄。 TOAST 多事务 ID 最小冻结年龄 TOAST 表 vacuum_multixact_freeze_min_age 参数的每表取值。注意，自动清理会忽略大于系统范围 autovacuum_multixact_freeze_max_age 设置一半的每表 autovacuum_multixact_…存储参数 · TOAST 表 toast.autovacuum_multixact_freeze_table_age存储参数本站词条对 TOAST 表单独设置。为当前关系设置触发积极冻结扫描的多事务 ID 年龄阈值。 TOAST 多事务 ID 全表冻结年龄 TOAST 表 vacuum_multixact_freeze_table_age 参数的每表取值。 WITH (toast.autovacuum_multixact_freeze_table_age = value) 适用对象 TOAST 表 取值类型…存储参数 · TOAST 表 toast.autovacuum_vacuum_cost_delay存储参数本站词条对 TOAST 表单独设置。覆盖当前关系自动清理时采用的代价节流延迟。 TOAST 自动清理代价延迟 TOAST 表 autovacuum_vacuum_cost_delay 参数的每表取值。 WITH (toast.autovacuum_vacuum_cost_delay = value) 适用对象 TOAST 表 取值类型 整数 TOAST 参数的继承 该选项控制主表附属…存储参数 · TOAST 表 toast.autovacuum_vacuum_cost_limit存储参数本站词条对 TOAST 表单独设置。覆盖当前关系自动清理时采用的代价节流上限。 TOAST 自动清理代价上限 TOAST 表 autovacuum_vacuum_cost_limit 参数的每表取值。 WITH (toast.autovacuum_vacuum_cost_limit = value) 适用对象 TOAST 表 取值类型 整数 TOAST 参数的继承 该选项控制主表附属…存储参数 · TOAST 表 toast.autovacuum_vacuum_insert_scale_factor存储参数本站词条对 TOAST 表单独设置。设置计算插入触发自动清理阈值时使用的比例因子。 TOAST 插入触发清理比例因子 TOAST 表 autovacuum_vacuum_insert_scale_factor 参数的每表取值。 WITH (toast.autovacuum_vacuum_insert_scale_factor = value) 适用对象 TOAST 表 取值类型 浮点数…存储参数 · TOAST 表 toast.autovacuum_vacuum_insert_threshold存储参数本站词条对 TOAST 表单独设置。设置按插入元组数触发自动清理的基础阈值，或关闭这一路触发条件。 TOAST 插入触发清理基础阈值 TOAST 表 autovacuum_vacuum_insert_threshold 参数的每表取值。特殊值 -1 可用于禁用该表上的由插入触发的清理。 WITH (toast.autovacuum_vacuum_insert_threshold = v…存储参数 · TOAST 表 toast.autovacuum_vacuum_max_threshold存储参数本站词条对 TOAST 表单独设置。为当前关系设置自动清理触发阈值的上限。 TOAST 自动清理阈值上限 TOAST 表 autovacuum_vacuum_max_threshold 参数的每表取值。 WITH (toast.autovacuum_vacuum_max_threshold = value) 适用对象 TOAST 表 取值类型 整数 TOAST 参数的继承 该选项控制…存储参数 · TOAST 表 toast.autovacuum_vacuum_scale_factor存储参数本站词条对 TOAST 表单独设置。设置按关系规模计算自动清理触发阈值时使用的比例因子。 TOAST 自动清理比例因子 TOAST 表 autovacuum_vacuum_scale_factor 参数的每表取值。 WITH (toast.autovacuum_vacuum_scale_factor = value) 适用对象 TOAST 表 取值类型 浮点数 TOAST 参数的继承 …存储参数 · TOAST 表 toast.autovacuum_vacuum_threshold存储参数本站词条对 TOAST 表单独设置。为当前关系设置按更新或删除元组数触发自动清理的基础阈值。 TOAST 自动清理基础阈值 TOAST 表 autovacuum_vacuum_threshold 参数的每表取值。 WITH (toast.autovacuum_vacuum_threshold = value) 适用对象 TOAST 表 取值类型 整数 TOAST 参数的继承 该选项控…存储参数 · TOAST 表 toast.log_autovacuum_min_duration存储参数本站词条对 TOAST 表单独设置。为当前关系设置记录自动清理相关日志的最短执行时长。 TOAST 自动清理日志时长阈值 TOAST 表 log_autovacuum_min_duration 参数的每表取值。 WITH (toast.log_autovacuum_min_duration = value) 适用对象 TOAST 表 取值类型 整数 TOAST 参数的继承 该选项控制…存储参数 · TOAST 表 toast.vacuum_index_cleanup存储参数本站词条对 TOAST 表单独设置。控制 VACUUM 是否处理当前关系的索引死元组，取值与默认行为随版本变化。 TOAST 清理索引死元组 TOAST 表 在该表上运行 VACUUM 时启用或禁用索引清理。默认值为 true。禁用索引清理可以显著加快 VACUUM，但如果表经常修改，也可能导致索引严重膨胀。如果指定了 INDEX_CLEANUP 参数（属于 VACUUM），则会覆盖此…存储参数 · TOAST 表 toast.vacuum_max_eager_freeze_failure_rate存储参数本站词条对 TOAST 表单独设置。为当前关系覆盖 VACUUM 提前冻结扫描的失败比例上限。 TOAST 提前冻结失败比例上限 TOAST 表 vacuum_max_eager_freeze_failure_rate 参数的每表取值。 WITH (toast.vacuum_max_eager_freeze_failure_rate = value) 适用对象 TOAST 表 取值类型…存储参数 · TOAST 表 toast.vacuum_truncate存储参数本站词条对 TOAST 表单独设置。控制 VACUUM 是否尝试将关系末尾的空页归还操作系统。 TOAST 截断尾部空页 TOAST 表 允许或禁止清理尝试截断删除此表末尾的空页。默认值为 true。如果为 true， VACUUM 和自动清理会执行截断，并将被截断页面的磁盘空间返还给操作系统。请注意，截断需要对表取得 ACCESS EXCLUSIVE 锁。如果指定了 TRUNCATE…存储参数 · TOAST 表 toast_tuple_target存储参数本站词条设置触发长字段压缩或外置的元组长度，以及 TOAST 处理试图达到的目标长度。 TOAST 元组目标长度 表与物化视图 toast_tuple_target 指定在尝试压缩和/或将长列值移入 TOAST 表之前所需的最小元组长度，同时也是一旦开始 TOAST 化后试图将长度缩减到其以下的目标长度。这会影响标记为 External（用于移动）、Main（用于压缩）或 Extend…存储参数 · 表与物化视图 toast_value_type存储参数本站词条指定新建 TOAST 关系的 chunk_id 类型；修改此参数不会改变已有 TOAST 关系的类型。 TOAST 值标识符类型 表与物化视图 指定为此表创建 TOAST 关系时使用的 chunk_id 属性类型。默认值为 oid； oid8 改为分配 oid8，它以每个行外指针多占用四字节为代价，允许更多不同的经过 TOAST 处理的值。不能为 TOAST 表设置此参数。 仅…存储参数 · 表与物化视图 toastinfo扩展与模块扩展目录显示TOAST字段的详细信息 show details on toasted datums toastinfo 监控统计监控统计 · 扩展目录 topn扩展与模块扩展目录top-n JSONB 的类型 type for top-n JSONB topn 函数与聚合函数与聚合 · 扩展目录 town扩展与模块扩展目录用于创建 JSONB/数组时序表并配置 GIN 与 GiST 索引的轻量 PL/pgSQL 辅助扩展。 Minimal PL/pgSQL helper that creates JSONB-and-array time-series tables with GIN and GiST indexes. jsonb time-series utility town 时序与时态时序与时态 · 扩展目录 tqvector扩展与模块扩展目录提供量化压缩与距离函数的向量类型 Compressed vector type with quantization and distance functions vectors quantization pgrx turboquant-pro AI 与向量AI 与向量 · 扩展目录 trace_connection_negotiation配置参数本站词条记录认证前连接握手的详细信息。 Logs details of pre-authentication connection handshake. trace_connection_negotiation：记录认证前连接握手的详细信息。实测在档范围为 PG17–19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 off，context 为 postmaster。…配置参数 · 开发者选项 trace_lock_oidmin配置参数PG18trace_lock_oidmin (integer) 如果设置，不会跟踪 OID 小于此值的表上的锁（用于避免在系统表上的输出）。 只有在编译 PostgreSQL 时定义了 LOCK_DEBUG 宏，这个参数才可用。开发人员选项 trace_lock_table配置参数PG18trace_lock_table (integer) 无条件地跟踪此表（OID）上的锁。 只有在编译 PostgreSQL 时定义了 LOCK_DEBUG 宏，这个参数才可用。开发人员选项 trace_locks配置参数PG18trace_locks (boolean) 如果开启，发出锁使用情况的信息。被转储信息中包括锁操作的类型、锁的类型和被锁或被解锁对象的唯一标识符。同样包括的还有已经授予这个对象的锁类型的位掩码和等待这个对象的锁类型的位掩码。还会转储每种锁类型已授予的锁数、等待的锁数，以及它们的总数。一个日志文件输出的示例如下： LOG: LockAcquire: new: lock(0xb7a…开发人员选项 trace_lwlocks配置参数PG18trace_lwlocks (boolean) 如果开启，发出轻量级锁的使用信息。轻量级锁主要是为了提供对共享内存数据结构的互斥访问。 只有在编译 PostgreSQL 时定义了 LOCK_DEBUG 宏，这个参数才可用。开发人员选项 trace_notify配置参数本站词条为 LISTEN 和 NOTIFY 生成调试输出。 Generates debugging output for LISTEN and NOTIFY. trace_notify：为 LISTEN 和 NOTIFY 生成调试输出。实测在档范围为 PG9.0–19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 off，context 为 user。这是测试版快照事…配置参数 · 开发者选项 trace_recovery_messages配置参数本站词条控制恢复相关调试消息的日志级别。 Enables logging of recovery-related debugging information. trace_recovery_messages：控制恢复相关调试消息的日志级别。实测在档范围为 PG9.0–16；最后在档的 PG16 启动默认值为 log，context 为 sighup。它在 PG17 被移除。 PG16 …配置参数 · 开发者选项 trace_sort配置参数本站词条输出排序操作的资源使用信息。 Emit information about resource usage in sorting. trace_sort：输出排序操作的资源使用信息。实测在档范围为 PG9.0–19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 off，context 为 user。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能…配置参数 · 开发者选项 trace_userlocks配置参数PG18trace_userlocks (boolean) 如果开启，发出关于用户锁使用的信息。与 trace_locks 的输出一样，但只用于咨询锁。 只有在编译 PostgreSQL 时定义了 LOCK_DEBUG 宏，这个参数才可用。开发人员选项 traceam扩展与模块扩展目录简单表访问方法，仅打印调用的访问方法及相关函数 Simple table access method that just prints out what functions in the access methods and related functions that are called. traceam 功能特性功能特性 · 扩展目录 track_activities配置参数本站词条收集会话当前执行命令的信息。 Collects information about executing commands. track_activities：收集会话当前执行命令的信息。实测在档范围为 PG9.0–19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 on，context 为 superuser。这是测试版快照事实，PostgreSQL 19 正…配置参数 · 运行时统计数据 / 累积查询和索引统计 track_activity_query_size配置参数本站词条设置 pg_stat_activity.query 预留的字节数。 Sets the size reserved for pg_stat_activity.query, in bytes. track_activity_query_size：设置 pg_stat_activity.query 预留的字节数。实测在档范围为 PG9.0–19 Beta 4；最后在档的 PG19 B…配置参数 · 运行时统计数据 / 累积查询和索引统计 track_commit_timestamp配置参数本站词条记录事务提交时间。 Collects transaction commit time. track_commit_timestamp：记录事务提交时间。实测在档范围为 PG9.5–19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 off，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。 记录事务…配置参数 · 复制 / 发送服务器