登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  MySQL

MySQL ANSI_QUOTES 开启后标识符为何变化

来源:17golang原创

时间:2026-10-15 00:45:33 279浏览 收藏

MySQL 开启 ANSI_QUOTES 后,双引号中的内容会被当成标识符,而不是字符串。变化的是 SQL 的解析含义,不是数据库把表名或列名改了。原来表示文本的 "ready",放在列引用位置时可能变成对 ready 列的引用。

对只面向 MySQL 的 SQL,简单的约定是:字符串用单引号,需要引用的标识符用反引号;动态数据交给驱动参数绑定。ANSI_QUOTES 开启后反引号仍可使用。本文按 MySQL 8.4 的引号规则展开,不涉及全局模式切换或生产数据修改。

官方文档:https://dev.mysql.com/doc/refman/8.4/en/sql-mode.html

把名称和数据值分开写

假设查询的是任务状态:tasks 是表名,status 是列名,ready 是要比较的数据值。它们即使都由字符构成,在 SQL 中也不是同一类对象。

-- 片段假设 tasks 表已有 status 列:反引号表示名称,单引号表示数据值
SELECT `status`
FROM `tasks`
WHERE `status` = 'ready';

这个写法在 ANSI_QUOTES 开启和关闭时都不依赖双引号的含义。不要把三个位置统一加双引号,也不要靠全局替换把所有双引号改成单引号:表名位置和数据值位置需要分别处理。

双引号改变的是解析含义

标识符用于指向数据库对象或查询中的名称;字符串字面量用于提供文本值。ANSI_QUOTES 的关键作用,是让双引号承担标识符引用的角色。MySQL 的字符串规则与对象命名规则分别说明了这两类对象。

写法未开启 ANSI_QUOTES开启 ANSI_QUOTES
'ready'字符串字符串
"ready"字符串标识符
`ready`引用标识符引用标识符

表格描述普通表达式中的引号含义,不把别名声明等特定语法位置简化成“所有位置都一样”。开启后也不意味着所有名称都必须加引号,合法的普通名称仍可按语法不加引号使用。

ANSI_QUOTES 与双引号、单引号、反引号的静态语义关系
图1:引号语义结构图。连接模式影响双引号所表达的对象类型;单引号与反引号分别保持值与名称的职责。不是运行截图。

连接配置是 SQL 调用契约的一部分

同一条 SQL 在两个客户端表现不同,应先看实际执行它的连接,而不是只看服务器全局默认值。应用、迁移工具与管理工具可能使用不同的会话配置。

-- 在发生差异的同一个连接中读取,不用另一客户端代替
SELECT @@SESSION.sql_mode AS connection_mode,
       @@GLOBAL.sql_mode AS server_mode;

SET SESSION 只影响当前客户端连接。修改 GLOBAL 值则影响之后新连接的默认模式,不会直接把已有连接全部改成新值。此范围来自MySQL SQL 模式说明。

不要为了打开一个选项就写 SET SESSION sql_mode = 'ANSI_QUOTES' 并当作“追加”。赋值会替换模式集合,原有严格模式等选项可能被移除。下文示例先保存原值,只增删 ANSI_QUOTES,最后恢复。连接池场景还应明确每条物理连接的初始化策略,不能把某一次借用连接的 SET 当成全池配置。

没有报错也可能读错列

开启后,如果查询中的 "ready" 在当前作用域找不到对应列,可能出现未知列错误。这不是证明表结构发生了变化,而是本来想写的数据值被解析成了名称。

更容易漏掉的是:表中恰好有一个 ready 列。此时语句可能合法,但读取的是列里的数据,不再是固定字符串。例如该列存着 archived,查询里的双引号表达式就可能得到 archived。只看“SQL 执行成功”无法判断调用方的原意是否得到保留。

出现这种差异,应把具体表达式拆成“名称还是值”,再结合当前会话模式判断。不要把未知列错误一律转成空结果,也不要用重试掩盖语义变化;如果同名列确实存在,重试仍然会执行同一种含义。

SQL 调用方的字段名称、数据值、会话模式与列引用职责
图2:查询契约结构图。ready 列名与 ready 文本值分属不同分组;双引号表达式受会话模式影响。连线仅表示静态依赖,不是执行顺序或实测结果。

迁移时统一生成器与参数写法

让 SQL 生成器分别接收字段名和数据值。字段名从固定映射或允许集合选择,再按数据库方言引用;数据值通过驱动支持的绑定方式传入。参数占位符的具体形式以驱动文档为准,不能把本来用于数据的占位符当成动态表名或列名。

手写 MySQL SQL 可以统一反引号名称与单引号字面量;需要跨数据库生成 SQL,则由方言层决定名称引用方式。如果迁移脚本使用双引号引用对象,就需要明确它依赖 ANSI_QUOTES,而不是期待每个客户端碰巧有相同默认值。

同时避免把 ANSI 与 ANSI_QUOTES 混为一谈:ANSI 是组合模式,影响不止引号。单纯处理双引号问题时,不应把更大范围的组合模式作为无差别替代。

用临时表对照并恢复连接

下面是供读者在独立测试连接执行的对照 SQL,未声称已在本机运行。它需要已选定可创建临时表的测试数据库,并有相应权限;所有语句必须在同一会话中执行。示例只创建当前连接的临时对象,不修改业务表,也不执行 SET GLOBAL。

-- 保存当前会话的完整模式,结束时按原值恢复
SET @quote_demo_old_mode = @@SESSION.sql_mode;

-- 模式名按逗号边界删除,只移除 ANSI_QUOTES,保留其余选项
SET @quote_demo_plain_mode =
  TRIM(BOTH ',' FROM REPLACE(
    CONCAT(',', @quote_demo_old_mode, ','),
    ',ANSI_QUOTES,', ','
  ));

-- 使用临时表,并让列名 ready 与文本值 ready 故意形成对照
CREATE TEMPORARY TABLE `quote_mode_demo` (
  `ready` VARCHAR(20) NOT NULL
);
INSERT INTO `quote_mode_demo` (`ready`) VALUES ('archived');

-- 未开启时,双引号表达式是固定字符串;第二列一直明确引用字段
SET SESSION sql_mode = @quote_demo_plain_mode;
SELECT "ready" AS double_quote_value,
       `ready` AS explicit_column_value
FROM `quote_mode_demo`;

-- 在保留其他模式的前提下添加 ANSI_QUOTES
SET SESSION sql_mode = CONCAT_WS(
  ',', NULLIF(@quote_demo_plain_mode, ''), 'ANSI_QUOTES'
);
SELECT "ready" AS double_quote_value,
       `ready` AS explicit_column_value
FROM `quote_mode_demo`;

-- 单引号文本不依赖 ANSI_QUOTES,反引号仍然引用同一个列
SELECT 'ready' AS literal_value,
       `ready` AS explicit_column_value
FROM `quote_mode_demo`;

-- 清理本连接的临时对象并恢复原模式
DROP TEMPORARY TABLE `quote_mode_demo`;
SET SESSION sql_mode = @quote_demo_old_mode;

按文档语义预期:第一次查询的两列分别为 ready 与 archived;开启后的第二次查询,两列都引用 ready 列,因而都对应 archived;第三次查询再次明确区分固定文本与列值。这里的预期用于解释语法,不是采集的数据库输出。

若中途出错导致脚本停止,应在该连接补做恢复语句与临时表清理,或关闭这个独立测试连接。不要把尚未恢复的连接返回业务连接池。示例没有处理存储对象的创建模式,也不作为整体数据库迁移脚本。

常见问题

开启后反引号还能用吗?能。ANSI_QUOTES 增加双引号作为标识符引用的含义,没有禁用反引号。

改 GLOBAL 为什么当前客户端不变?已有连接保有自己的会话值;读取正在执行 SQL 的 SESSION 值,才能说明当前语句所处的模式。

只改引号能解决所有迁移问题吗?不能。这里只处理标识符与字符串的区别,函数、类型以及其他方言差异需要分别处理。

引号不是装饰。稳定的调用契约应同时说明名称如何引用、值如何绑定,以及连接需要什么模式。把这三件事分开,才能避免“SQL 没报错,含义却变了”。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>