GoldenDB保留字速查清单：避开SQL建表语法错误的实用指南

写SQL写到一半，报了个语法错误，提示某个字段名是保留字不能用——这种事但凡用数据库的人都碰到过。尤其GoldenDB这类分布式数据库，表面上兼容MySQL语法，可真到建表、写存储过程、做数据迁移的时候，冷不丁就冒出来一个你完全没印象的保留字，把整条DDL给拦住了。

这篇文章就是来解决这个问题的。我基于GoldenDB兼容MySQL语法的前提，把内部保留字按字母排序整理成一份速查清单，并把实战中容易踩的坑、排查思路、规避方法一并写清楚。无论你是刚接触GoldenDB的新手，还是已经在生产环境里维护分布式实例的老手，这份清单都能让你少走不少弯路。

1. 保留字为什么值得专门收集一份清单

先说说保留字这事的本质。数据库的SQL解析器在工作的时候，会先把一条语句拆成一个个token，然后根据语法规则去匹配这些token的含义。为了语法规则清晰、没有歧义，解析器会预留一部分单词作为语法结构的一部分，这些单词就是保留字。比如SELECT、FROM、WHERE，这些词如果在建表的时候拿来当字段名，解析器就分不清这个字段名到底是关键字还是普通标识符，只能直接报错。

GoldenDB作为分布式数据库，它的SQL引擎在兼容MySQL语法的基础上做了一层扩展。这里有个很容易被忽略的点：保留字不是一成不变的，它会随着数据库版本迭代不断增减。MySQL 8.0的保留字列表比5.7多了一批，比如CUBE、EMPTY、FUNCTION、GROUPING这些，5.7时代还能当字段名用，到了8.0就直接被禁了。GoldenDB跟随这个演进节奏，所以你在老版本能用的字段名，在新版本实例上可能就突然建不了表了。

还有一点，GoldenDB因为是分布式架构，集群里有计算节点和存储节点，SQL语句要经过解析、计划生成、下推执行多个环节。保留字的冲突如果发生在建表阶段还好，至少报错清晰；怕的是已经存在的表，因为某个后台脚本里用了保留字做列名，在数据导入或者查询下推的时候才暴露问题，这个时候排查成本就高了。

所以一份按字母排序的保留字清单，真正的价值在于：你在写建表语句、写存储过程、做数据迁移脚本之前，可以先对着清单把表名字段名过一遍，把潜在冲突消灭在写代码阶段。字母排序还有个额外好处——查起来快，不用在文档里翻半天。你写了一个字段叫rank，拿不准是不是保留字，直接定位到R开头的区间，扫一眼就知道结果。

2. GoldenDB场景下保留字的三个容易忽略的特点

2.1 GoldenDB保留字集合不等于MySQL保留字集合

很多人在GoldenDB上建表遇到保留字报错，第一反应是去翻MySQL的保留字文档。这个动作是对的，但只能解决80%的问题。GoldenDB作为分布式数据库，在SQL语法上除了兼容MySQL，还有自己的一套扩展语法，涉及到分布式表、全局索引、表组等概念。这些扩展语法里用到的单词，虽然没有被列为严格保留字，但在特定上下文中会被解析器特殊处理。

举个实际例子，你在一个分布式表上创建索引，写CREATE GLOBAL INDEX这种语法时，GLOBAL这个词在普通SQL里可能不会报错，但在GoldenDB的DDL语法解析路径上就有特殊含义。所以我的建议是，凡是和分布式概念相关的单词，就算不在保留字清单里，设计表结构的时候也尽量避开。

2.2 非保留字和保留字的处理方式完全不同

MySQL的官方文档把关键字分成保留字和非保留字两类。保留字是绝对不能用做标识符的，除非用反引号包裹；非保留字则没有这个限制，直接当表名、字段名用没太大问题，只在特定语法上下文里需要注意。

GoldenDB对这两类的处理也延续了这个逻辑。问题在于，很多开发者在网上搜到某个词"不是保留字"，就放心大胆去用了，却没注意这个词可能是非保留字里的特殊情况。比如LEADING、TRAILING这类词，它们是非保留字，但如果你在ORDER BY子句里用LEADING作为列名，解析器依然可能产生歧义。所以我的实践原则很简单：能用普通名字解决的问题，坚决不用关键字的边缘词去碰运气。

2.3 大小写和反引号转义并不是万能解药

遇到保留字冲突，最常见的操作就是给字段名加上反引号。比如说你有个字段叫select，写成select，在建表语句里确实能过。但问题在于，这个字段后续会被各种ORM框架、报表工具、数据分析脚本引用，每个查询都要记得加反引号。但凡有一处忘了，线上就直接报错。

更麻烦的是，分布式场景下SQL语句会经过多个节点的解析和改写，某些内部改写逻辑可能不会保留你的反引号转义。这说明白一点就是：你在客户端执行的时候没报错，不代表集群内部执行引擎处理的时候不出问题。所以反引号只是应急手段，最稳妥的做法是在设计阶段就彻底避开保留字。

3. 字母排序速查表：A到Z完整对照

下面这份清单基于GoldenDB兼容MySQL语法的保留字集合整理，按字母顺序排列。我在整理的时候删掉了一些生僻的、只在特定功能模块里出现的词汇，保留的是实际建表和写SQL时最常遇到的。表格里的"类型"按照保留字、非保留字、分布式相关敏感词三类标注，方便你快速判断风险等级。

3.1 A到D开头