MySQL sys.quote_identifier 怎样处理名称中的反引号
来源:17golang原创
时间:2026-11-16 18:37:18 304浏览 收藏
sys.quote_identifier() 会在名称外加一对反引号,并把名称内部每个反引号写成两个。输入 sales`detail,对应的标识符文本就是 `sales``detail`。传入原始名称即可,不要先手工加引号再交给函数。
官方文档:https://dev.mysql.com/doc/refman/8.4/en/sys-quote-identifier.html
先判断拼入 SQL 的是对象名还是数据值
导出工具需要按配置选择一张表,报表工具需要拼接一个字段名,这些位置承载的是标识符。客户姓名、订单状态、查询阈值则是数据值。两类内容应使用不同处理方式:对象名需要标识符引用,条件值优先使用参数绑定。
如果表名固定,直接在 SQL 中写明名称最清楚。只有确实需要动态名称,才需要选择引用工具。把任何输入都交给同一个“转义函数”,容易让值的引号规则混入对象名处理。
比较 sys 函数、手工转义和参数绑定
| 方案 | 合适位置 | 选择条件 |
|---|---|---|
| sys.quote_identifier | 单个对象名称 | 在 MySQL 内生成 SQL 文本,环境提供 sys 函数 |
| 手工加倍反引号 | 单个对象名称 | 需要在应用端封装,并统一维护 MySQL 引用规则 |
| 预处理参数绑定 | 数据值 | WHERE 条件中的状态、编号等值需要变化 |
| 固定映射或白名单 | 可选对象集合 | 产品只允许访问已配置的少数对象 |
这几种方案可以配合使用。白名单决定允许选哪一个对象,引用函数负责把名称表示成 SQL 标识符,参数绑定负责条件值。引用并不证明对象存在,也不替代访问范围配置。

用单个名称展示反引号的加倍规则
-- 原始名称作为字符串传入,函数返回带引用符的标识符文本
SET @name = 'sales`detail';
SELECT sys.quote_identifier(@name) AS quoted_name;
-- 手工实现同一引用规则:内部反引号加倍,外层再加一对
SELECT CONCAT('`', REPLACE(@name, '`', '``'), '`') AS manual_name;
这段示例只计算文本,不创建表。按引用规则,两种表达式都应产生 `sales``detail`。内部两个连续反引号代表名称里的一个实际反引号,外侧的一对负责界定名称。
手工方案的重点在于先对原始内容做替换,再补外层引用符。若只补外层符号,名称中的反引号仍会干扰标识符边界。若对已经引用过的文本再执行一次,引用符也会变成名称内容;因此应用接口应明确接收“原始名称”,并避免在多层封装中重复处理。
库名和表名分开引用再组合
限定名由独立部分和分隔点组成。应先分别引用库名、表名,再在两者之间加入点号。把完整的 reporting.sales_detail 一次传给函数,得到的是一个整体标识符文本,并没有表达两个独立的名称部分。
-- 分别引用库名和表名;这里仅生成 SQL 文本,不执行查询 SET @schema_name = 'reporting'; SET @table_name = 'sales`detail'; SET @sql_text = CONCAT( 'SELECT COUNT(*) FROM ', sys.quote_identifier(@schema_name), '.', sys.quote_identifier(@table_name), ' WHERE status = ?' ); SELECT @sql_text AS statement_text;
这里的 @sql_text 是待使用的 SQL 文本,示例没有执行它,也不要求示例表实际存在。其名称部分采用逐段引用,条件值保留 ?,后续由预处理接口绑定。参数标记用于数据值位置,不能把表名、列名等标识符留成参数标记。

标识符规则:https://dev.mysql.com/doc/refman/8.4/en/identifiers.html
预处理参数说明:https://dev.mysql.com/doc/refman/8.4/en/prepare.html
按适用条件选择方案并处理常见疑问
在库内编写 SQL 文本生成器,且能够调用 sys 函数时,优先使用 sys.quote_identifier,让调用处直接说明意图。在应用层统一构造名称,可使用数据库方言提供的标识符引用能力;若必须自行实现,将加倍规则集中到一个接收原始名称的函数,并把名称来源和允许访问的对象集合写清楚。
不要把这个函数当作通用 SQL 修复器:它返回 TEXT,不检查一整条 SQL 的语法;也不会替你拆解库、表、列的层级。长度、字符范围以及对象类型的命名限制仍需遵守。
为什么不能把表名直接绑定到问号?
预处理时 SQL 的对象位置需要被解析。参数标记承载数据值,不是动态表名替换机制;动态名称应先由固定映射选定,再按标识符规则构造文本。
QUOTE() 能代替这个函数吗?
不能混用。字符串字面量和标识符属于不同语法位置。处理名称时应使用标识符引用规则,条件值交给绑定接口。
函数返回带反引号的文本,是否说明表已经存在?
不是。引用结果只是一种名称表示。生成 SQL 与数据库中是否存在对应对象,是两件独立的事。
-
374 收藏
-
499 收藏
-
384 收藏
-
184 收藏
-
265 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习