CONFIGURATION PARAMETER版本和平台兼容性 / 以前的 PostgreSQL 版本
escape_string_warning
当普通字符串字面量含反斜杠转义时发出警告。
Warn about backslash escapes in ordinary string literals.
布尔 会话 引入 9.0（基线） 于 19 移除 0 次默认值变更
- 类型
- 布尔bool
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
on- 引入版本
- 9.0（基线）
- 状态
- 于 19 移除
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–18 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 9.1 完全一致，下面就是同一段文字。
打开时，如果在普通字符串字面量中（'...'语法）出现了一个反斜线（\）并且standard_conforming_strings为关闭，那么就会发出一个警告。默认值是on。
希望使用反斜线作为转义符的应用应该被修改来使用转义字符串语法（E'...'），因为按照 SQL 标准，普通字符串现在默认将反斜线视作一个普通字符。这个变量可以被启用来帮助定位需要被更改的代码。
机制详解
当普通字符串字面量含反斜杠转义时发出警告。它可在会话级修改，因此不同会话可能采用不同的行为。
该兼容开关改变旧客户端或旧 SQL 的解析/输出行为，而不是执行计划的常规性能旋钮。长期方案应修复客户端与 SQL，并在升级测试中移除兼容依赖。
应把 escape_string_warning 与 array_nulls、backslash_quote、standard_conforming_strings 一起监控和变更。先在对应角色与真实负载上验证，再按其 user context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
保持现代默认并修复依赖 escape_string_warning 的旧客户端/SQL；先在会话级做迁移测试，不要把兼容开关永久设为集群全局策略。
-
OLAP分析与批处理
重点回归 ETL、生成 SQL 与旧驱动，因为它们常隐藏解析/引用假设；性能差异通常不是调该开关的理由。
-
小规格低配实例与开发机
没有遗留需求就保持默认。若临时启用，记录责任人、受影响连接与移除日期。
常见问题
- 把兼容开关当作永久方案而不修复客户端。
- 只在一个会话测试，却全局部署到所有应用。
- 混淆解析兼容性与数据或安全兼容性。
- 升级后忘记清理已经不需要的覆盖。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 19 ← 18 移除此参数
该版起不再存在
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 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 |
— |
会话 |
布尔 |
— |
— |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 以前的 PostgreSQL 版本 10 | |||||
array_nulls |
布尔 | 会话 | on |
— | |
| 允许在数组输入中使用 NULL 元素。 | 现存 | ||||
backslash_quote |
枚举 | 会话 | safe_encoding |
— | |
| 设置字符串字面量中是否允许使用反斜杠转义的单引号（\'）。 | 现存 | ||||
default_with_oids |
布尔 | 会话 | off |
— | |
| 默认创建带 OID 的新表。 | 于 12 移除 | ||||
escape_string_warning |
布尔 | 会话 | on |
— | |
| 当普通字符串字面量含反斜杠转义时发出警告。 | 于 19 移除 | ||||
lo_compat_privileges |
布尔 | 会话（超级用户） | off |
— | |
| 启用大对象权限检查的向后兼容模式。 | 现存 | ||||
operator_precedence_warning |
布尔 | 会话 | off |
— | |
| 对自 PostgreSQL 9.4 起含义发生变化的表达式发出警告。 | 于 14 移除 | ||||
quote_all_identifiers |
布尔 | 会话 | off |
— | |
| 生成 SQL 片段时引用所有标识符。 | 现存 | ||||
sql_inheritance |
布尔 | 会话 | on |
— | |
| 让多种 SQL 命令默认包含继承子表。 | 于 10 移除 | ||||
standard_conforming_strings |
布尔 | 会话 | on |
9.11 次 | |
| 使普通单引号字符串中的反斜杠按字面处理。 | 现存 | ||||
synchronize_seqscans |
布尔 | 会话 | on |
— | |
| 启用同步顺序扫描。 | 现存 | ||||