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

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

文档 / 配置参数 / 版本和平台兼容性

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

backslash_quote

设置字符串字面量中是否允许使用反斜杠转义的单引号（\'）。

Sets whether "\'" is allowed in string literals.

枚举 会话 引入 9.0（基线） 现存至 20 devel 0 次默认值变更

类型
枚举enum
上下文
会话任何用户都可在会话内用 SET 修改
默认值
safe_encoding
枚举值
safe_encoding, on, off
分类
版本和平台兼容性 / 以前的 PostgreSQL 版本
引入版本
9.0（基线）
状态
现存

PostgreSQL 18 手册 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

safe_encoding 9.0 – 20

默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

本版译文与 PostgreSQL 14 完全一致，下面就是同一段文字。

这个参数控制字符串文本中的单引号是否能够用\'来表示。首选的 SQL 标准的方法是将其双写（''），但是PostgreSQL在历史上也接受\'。不过使用\'容易导致安全风险，因为在某些客户端字符集编码中，有多字节字符的最后一个字节在数值上等价于 ASCII 的\'。如果客户端代码没有做到正确转义，那么将会导致 SQL 注入攻击。如果服务器拒绝看起来带有被反斜线转义的单引号的查询，那么就可以避免这种风险。backslash_quote的可用值是on（总是允许\'）、off（总是拒绝）以及safe_encoding（只有客户端编码不允许在多字节字符中存在 ASCII \时允许）。safe_encoding是默认设置。

注意在符合标准的字符串文本中，\就表示\。这个参数只影响不符合标准的文本的处理，包括转义字符串语法（E'...'）。

机制详解

设置字符串字面量中是否允许使用反斜杠转义的单引号（\'）。它可在会话级修改，因此不同会话可能采用不同的行为。

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

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

调优建议

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

  • OLTP在线事务处理

    保持现代默认并修复依赖 backslash_quote 的旧客户端/SQL；先在会话级做迁移测试，不要把兼容开关永久设为集群全局策略。

  • OLAP分析与批处理

    重点回归 ETL、生成 SQL 与旧驱动，因为它们常隐藏解析/引用假设；性能差异通常不是调该开关的理由。

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

    没有遗留需求就保持默认。若临时启用，记录责任人、受影响连接与移除日期。

常见问题

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

演化历史

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

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

逐版本快照

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

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

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Version and Platform Compatibility 版本和平台兼容性 10 个 ↗
以前的 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 —
启用同步顺序扫描。 现存