↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 配置参数 / 版本和平台兼容性

CONFIGURATION PARAMETER版本和平台兼容性 / 以前的 PostgreSQL 版本

synchronize_seqscans

它允许对大型表的顺序扫描与其他扫描同步,因此并发扫描可以在几乎相同的时刻读取相同的块,这样可以分担 I/O 负载。

Enables synchronized sequential scans.

布尔 会话 引入 8.3 现存至 20 devel 0 次默认值变更

类型
布尔bool
上下文
会话任何用户都可在会话内用 SET 修改
默认值
on
引入版本
8.3
状态
现存

PostgreSQL 18.7 手册 官方文档

版本轨迹

相对 PostgreSQL 17 仅简述或分类有更新。

默认值变迁

on 9.0 – 19

已记录的默认值在 PostgreSQL 9.0–19 之间未变。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18.7 手册 · 19.13 版本和平台兼容性 本站手册 官方原文

它允许对大型表的顺序扫描与其他扫描同步,因此并发扫描可以在几乎相同的时刻读取相同的块,这样可以分担 I/O 负载。当启用这个参数时,一个扫描可能会从表的中间开始并且之后“绕回”到开头以覆盖所有的行,这样可以与已在进行中的扫描活动同步。对于没有 ORDER BY 子句的查询,这样的扫描可能会在返回行的顺序中造成不可预料的改变。将这个参数设置为 off 以保证 8.3 之前的行为(顺序扫描总是从表的起始处开始)。默认值是 on。

机制详解

启用同步顺序扫描。它可在会话级修改,因此不同会话可能采用不同的行为。

该兼容开关改变旧客户端或旧 SQL 的解析/输出行为,而不是执行计划的常规性能旋钮。长期方案应修复客户端与 SQL,并在升级测试中移除兼容依赖。

应把 synchronize_seqscans 与 default_with_oids、lo_compat_privileges、operator_precedence_warning 一起监控和变更。先在对应角色与真实负载上验证,再按其 user context 选择会话修改、reload 或 restart;历史默认值并不等于当前有效值。

调优建议

按典型负载给出的取值思路,不是放之四海皆准的配方:实际取值要看数据量、并发度与硬件。

  • OLTP在线事务处理

    通常保持开启,让并发大表扫描共享缓存足迹;需要确定行序时必须写 ORDER BY,不能靠关闭该参数。

  • OLAP分析与批处理

    分析负载最可能受益于 synchronized scans。只在可重复基准显示共享扫描位置损害局部性时做会话级试验。

  • 小规格低配实例与开发机

    保持默认;数据完全驻留缓存或几乎没有并发扫描时,它通常既无需调也不会成为瓶颈。

常见问题

  • 把兼容开关当作永久方案而不修复客户端。
  • 只在一个会话测试,却全局部署到所有应用。
  • 混淆解析兼容性与数据或安全兼容性。
  • 升级后忘记清理已经不需要的覆盖。

演化历史

相邻两个大版本之间的差异,新的在前。版本号链到该版的快照。

  1. PostgreSQL 18 ← 17 仅描述更新

    简述 Enable synchronized sequential scans. Enables synchronized sequential scans.

  2. PostgreSQL 8.3 ← 8.2 新增此参数

    PostgreSQL 8.3 起可用

逐版本快照

每个收录版本里的 7 项事实,与上一个存在的版本不同的格子带底色。版本号链到该版。

版本 默认值单位上下文类型最小值最大值枚举值
8.3 — — — 布尔 — — —
8.4 — — — 布尔 — — —
9.0 on — 会话 布尔 — — —
9.1 on — 会话 布尔 — — —
9.2 on — 会话 布尔 — — —
9.3 on — 会话 布尔 — — —
9.4 on — 会话 布尔 — — —
9.5 on — 会话 布尔 — — —
9.6 on — 会话 布尔 — — —
10 on — 会话 布尔 — — —
11 on — 会话 布尔 — — —
12 on — 会话 布尔 — — —
13 on — 会话 布尔 — — —
14 on — 会话 布尔 — — —
15 on — 会话 布尔 — — —
16 on — 会话 布尔 — — —
17 on — 会话 布尔 — — —
18 on — 会话 布尔 — — —
19 on — 会话 布尔 — — —
20 — — — 布尔 — — —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Version and Platform Compatibility 版本和平台兼容性 10 个 ↗
以前的 PostgreSQL 版本 10
array_nulls 布尔 会话 on —
这个参数控制数组输入解析器是否把未用引号的 NULL 识别为一个值为空值的数组元素。 现存
backslash_quote 枚举 会话 safe_encoding 8.41 次
这个参数控制转义字符串语法(E'...')中的单引号是否能够用\' 来表示。 现存
default_with_oids 布尔 会话 off —
此参数控制在既未指定 WITH OIDS 也未指定 WITHOUT OIDS 时,CREATE TABLE 和 CREATE TABLE AS 是否在新建表中包含 OID 列。 于 12 移除
escape_string_warning 布尔 会话 on —
打开时,如果在普通字符串字面量中('...' 语法)出现了一个反斜线(\)并且 standard_conforming_strings 为关闭,那么就会发出一个警告。 于 19 移除
lo_compat_privileges 布尔 会话(超级用户) off —
在 PostgreSQL 9.0 之前的版本中,大对象没有访问权限,因此始终可以被所有用户读取和写入。 现存
operator_precedence_warning 布尔 会话 off —
开启时,对于任何可能因操作符优先级的变化而在 PostgreSQL 9.4 之后改变含义的构造,解析器都会发出警告。 于 14 移除
quote_all_identifiers 布尔 会话 off —
当数据库产生 SQL 时,强制所有标识符被引号包围,即使它们(当前)不是关键字。 现存
sql_inheritance 布尔 会话 on —
这个设置控制不带修饰的表引用是否被认为包括继承子表。 于 10 移除
standard_conforming_strings 布尔 会话 on 9.11 次
从 PostgreSQL 19 开始,这个参数始终为 on。 现存
synchronize_seqscans 布尔 会话 on —
它允许对大型表的顺序扫描与其他扫描同步,因此并发扫描可以在几乎相同的时刻读取相同的块,这样可以分担 I/O 负载。 现存