escape_string_warning
escape_string_warning:当普通字符串字面量含反斜杠转义时发出警告。实测在档范围为 PG9.0–18;最后在档的 PG18 启动默认值为 on,context 为 user。它在 PG19 Beta 3 被移除。
说明
Fact — 官方简述译文:当普通字符串字面量含反斜杠转义时发出警告。
身份
生命周期
| Fact | 值 |
|---|---|
| 首次观测 | PG9.0(研究下界) |
| 在档版本 | PG9.0–18 |
| 移除版本 | PG19 Beta 3 |
| 引入提交 | 不作断言:早于 PG9.0 研究边界 |
| 提交日期 | — |
| Discussion | — |
默认值变迁
| 版本 | 原始 boot_val |
单位 | 人类可读值 |
|---|---|---|---|
| PG9.0–18 | on |
— | on |
机制详解
当普通字符串字面量含反斜杠转义时发出警告。它可在会话级修改,因此不同会话可能采用不同的行为。
该兼容开关改变旧客户端或旧 SQL 的解析/输出行为,而不是执行计划的常规性能旋钮。长期方案应修复客户端与 SQL,并在升级测试中移除兼容依赖。
应把 escape_string_warning 与 array_nulls、backslash_quote、standard_conforming_strings 一起监控和变更。先在对应角色与真实负载上验证,再按其 user context 选择会话修改、reload 或 restart;历史默认值并不等于当前有效值。
调优建议
提示
Advice。 以下建议是工作负载起点,必须用真实测量验证。
| 场景 | 建议 |
|---|---|
| OLTP | 保持现代默认并修复依赖 escape_string_warning 的旧客户端/SQL;先在会话级做迁移测试,不要把兼容开关永久设为集群全局策略。 |
| OLAP | 重点回归 ETL、生成 SQL 与旧驱动,因为它们常隐藏解析/引用假设;性能差异通常不是调该开关的理由。 |
| 小规格 | 没有遗留需求就保持默认。若临时启用,记录责任人、受影响连接与移除日期。 |
Pigsty 取值
以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具,并按 PG18 渲染当前 Pigsty 模板;这不表示 Pigsty 当前支持该历史或测试版本。
| 模板 | 有效值 | 与上游 boot 比较 | 源表达式 |
|---|---|---|---|
| OLTP | 未修改 | — | — |
| OLAP | 未修改 | — | — |
| CRIT | 未修改 | — | — |
| TINY | 未修改 | — | — |
注意
Advice — 待人工复核。 当前 Pigsty 模板投影事实:OLTP: PG9.0–18 未修改;OLAP: PG9.0–18 未修改;CRIT: PG9.0–18 未修改;TINY: PG9.0–18 未修改。 未发现覆盖值,因此不推断 Pigsty 专属理由。
常见坑
- 把兼容开关当作永久方案而不修复客户端。
- 只在一个会话测试,却全局部署到所有应用。
- 混淆解析兼容性与数据或安全兼容性。
- 升级后忘记清理已经不需要的覆盖。
关联参数
array_nulls · backslash_quote · standard_conforming_strings · transform_null_equals · quote_all_identifiers · default_with_oids