1. KingbaseES与MySQL的兼容性背景
如果你正在从MySQL迁移到KingbaseES，或者需要在两个数据库之间切换使用，一定会关心它们的兼容性。作为国产数据库的佼佼者，KingbaseES在设计之初就考虑到了对MySQL的兼容问题。特别是在最新版本中，通过sql_mode参数的适配，已经能够很好地支持MySQL的常见语法特性。
我最近在一个电商项目中就遇到了这样的需求：客户原先使用的是MySQL，但由于某些原因需要迁移到KingbaseES。最让我头疼的就是那些在MySQL上运行良好的SQL语句，在KingbaseES上却报错。后来发现，通过合理配置sql_mode参数，大部分兼容性问题都能迎刃而解。
sql_mode就像是数据库的"行为模式开关"，它决定了数据库如何处理SQL语句中的各种特殊情况。KingbaseES目前主要兼容了MySQL中的三个关键参数：ONLY_FULL_GROUP_BY、ANSI_QUOTES和STRICT_ALL_TABLES。这三个参数分别控制着分组查询的严格性、引号的使用规则以及数据校验的严格程度。
2. ONLY_FULL_GROUP_BY参数详解
2.1 参数作用与默认行为
ONLY_FULL_GROUP_BY可能是最常引发问题的参数了。它控制着GROUP BY查询的严格性。在默认情况下，KingbaseES不启用这个参数，这意味着你可以写出这样的查询：
SELECT id, name, COUNT(*) FROM users GROUP BY id;即使name列没有出现在GROUP BY子句中，查询也能正常执行。这看起来很方便，但实际上隐藏着风险——返回的name值可能是不确定的，因为同一分组中可能有多个不同的name值。
2.2 启用后的行为变化
当你设置sql_mode='ONLY_FULL_GROUP_BY'后，情况就完全不同了。同样的查询会直接报错：
SET sql_mode = 'ONLY_FULL_GROUP_BY'; SELECT id, name, COUNT(*) FROM users GROUP BY id; -- 错误：字段 "users.name" 必须出现在 GROUP BY 子句中或者在聚合函数中使用这时，你必须确保SELECT列表中的每一列要么出现在GROUP BY子句中，要么被包含在聚合函数里。正确的写法应该是：
SELECT id, name, COUNT(*) FROM users GROUP BY id, name; -- 或者 SELECT id, MAX(name), COUNT(*) FROM users GROUP BY id;2.3 实际应用场景
我在处理一个报表系统时就遇到过这个问题。原先在MySQL上运行的复杂报表查询，迁移到KingbaseES后突然开始报错。经过排查发现是因为启用了ONLY_FULL_GROUP_BY。解决方案有两种：
- 修改SQL语句，确保符合标准SQL规范
- 临时关闭ONLY_FULL_GROUP_BY（不推荐长期使用）
对于新项目，我建议从一开始就启用这个参数，它能帮助你写出更规范的SQL语句，避免潜在的数据不一致问题。
3. ANSI_QUOTES参数解析
3.1 双引号的不同含义
ANSI_QUOTES参数控制着双引号的使用方式。这是一个很容易被忽视但却很重要的参数。在默认情况下，KingbaseES中的双引号用于引用字符串常量：
SELECT * FROM products WHERE name = "笔记本电脑";这种写法在未启用ANSI_QUOTES时是合法的，双引号和单引号的作用相同。但启用ANSI_QUOTES后，双引号就只能用于标识符（表名、列名等）的引用：
SET sql_mode = 'ANSI_QUOTES'; SELECT * FROM products WHERE name = "笔记本电脑"; -- 错误：字段 "笔记本电脑" 不存在正确的写法应该是使用单引号表示字符串：
SELECT * FROM products WHERE name = '笔记本电脑';3.2 标识符引用的正确方式
启用ANSI_QUOTES后，双引号可以用来引用包含特殊字符或保留字的标识符：
SELECT "user name" FROM "user-table";这在处理一些设计不规范的数据库时特别有用。我曾经接手过一个老系统，表名中包含了空格和连字符，如果没有ANSI_QUOTES，根本无法正常查询。
3.3 迁移注意事项
从MySQL迁移时，特别要注意SQL脚本中双引号的使用。我建议在迁移前先统一检查所有SQL语句，将字符串常量的双引号改为单引号。可以使用以下查询找出可能有问题的地方：
SELECT routine_definition FROM information_schema.routines WHERE routine_definition LIKE '%"%' AND routine_schema NOT LIKE 'pg_%';4. STRICT_ALL_TABLES参数深入
4.1 严格模式与非严格模式
STRICT_ALL_TABLES参数控制着数据校验的严格程度。在默认情况下，KingbaseES处于非严格模式，这意味着当你插入超过字段长度的数据时，只会收到警告，而操作仍会成功：
CREATE TABLE test (content VARCHAR(10)); INSERT INTO test VALUES ('这个字符串明显太长了'); -- 警告：value too long for type character varying(10) -- 插入成功，数据被截断4.2 启用严格模式的效果
启用STRICT_ALL_TABLES后，同样的操作会直接失败：
SET sql_mode = 'STRICT_ALL_TABLES'; INSERT INTO test VALUES ('这个字符串明显太长了'); -- 错误：value too long for type character varying(10) -- 插入失败4.3 实际应用建议
严格模式对于保证数据完整性非常重要。在一个金融项目中，我们曾经因为非严格模式导致金额数据被意外截断，造成了严重的对账问题。启用STRICT_ALL_TABLES后，这类问题在开发阶段就能被发现。
不过要注意，启用严格模式后，所有表的校验都会变严格。如果有些表确实需要保留非严格行为，可以考虑在应用层做处理，或者在执行特定操作时临时修改sql_mode：
-- 临时关闭严格模式 SET LOCAL sql_mode = ''; -- 执行需要非严格模式的操作 INSERT INTO legacy_table VALUES (...); -- 恢复严格模式 RESET sql_mode;5. 综合配置与最佳实践
5.1 参数组合使用
这三个参数可以组合使用，用逗号分隔：
SET sql_mode = 'ONLY_FULL_GROUP_BY,ANSI_QUOTES,STRICT_ALL_TABLES';这样的配置最接近MySQL的严格模式，适合新项目开发。我通常会在数据库初始化脚本中设置这些参数：
ALTER DATABASE mydb SET sql_mode = 'ONLY_FULL_GROUP_BY,ANSI_QUOTES,STRICT_ALL_TABLES';5.2 查看和修改配置
要查看当前的sql_mode设置：
SHOW sql_mode;如果需要永久修改，可以编辑KingbaseES的配置文件kingbase.conf，添加或修改以下行：
sql_mode = 'ONLY_FULL_GROUP_BY,ANSI_QUOTES,STRICT_ALL_TABLES'修改后需要重启数据库服务生效。
5.3 迁移路径建议
对于从MySQL迁移的项目，我建议按照以下步骤操作：
- 先在测试环境评估现有SQL语句
- 逐步启用各个参数，修复发现的问题
- 最后在生产环境统一配置
对于特别复杂的遗留系统，可以考虑先不启用这些参数，等逐步重构后再开启。
