金仓数据库 V8R3版本 兼容模式怎么看、怎么改

举报
yd_252438691 发表于 2026/11/12 16:40:50 2026/11/12
【摘要】 今天有大佬咨询 V8R3 版本下兼容模式如何看。扒拉一圈笔记,满眼都是 V8R6 和 V9 的;经大佬提醒「2020 年部署的那批是分 Oracle 和 MySQL 兼容模式的」,才想起来那时候还在用印象笔记。果不其然,在里面翻到了查看、更改兼容模式的步骤。好像 2021 年之后就换成语雀记录了,印象笔记的内容一直没迁移过来——还好这个产品还在。有需要的小伙伴可收藏。一句话版:V8R3 看兼...

今天有大佬咨询 V8R3 版本下兼容模式如何看。扒拉一圈笔记,满眼都是 V8R6 和 V9 的;经大佬提醒「2020 年部署的那批是分 Oracle 和 MySQL 兼容模式的」,才想起来那时候还在用印象笔记。

果不其然,在里面翻到了查看、更改兼容模式的步骤。好像 2021 年之后就换成语雀记录了,印象笔记的内容一直没迁移过来——还好这个产品还在。

有需要的小伙伴可收藏。

一句话版:V8R3 看兼容模式用 show all 或查 sys_settings;改模式认准 compatible_level,三条路——启动传 -c、ALTER DATABASE / SET、改 kingbase.conf 后重启。


一、先搞清楚:V8R3 的兼容模式由谁决定

V8R3 时代,兼容模式由参数 compatible_level 控制,取值主要是 oracle 和 mysql。2020 年前后部署的那批实例,在装库时就按业务需要分了 Oracle 兼容模式和 MySQL 兼容模式。

笔记里的示例路径是 /opt/Kingbase/ES/V7/data,属于更早期的安装目录;实际操作时一律以自己机器上的 data 目录为准,别照抄路径。

项目 说明
参数名 compatible_level
常见取值 oracle / mysql
配置文件 data 目录下的 kingbase.conf
配置文件写法 compatible_level = 'oracle'

二、查看兼容模式:笔记里的两条命令

-- 1)列出全部参数,从中找 compatible_level
show all;

-- 2)从系统视图按名字模糊查,输出更聚焦
select * from sys_catalog.sys_settings where name like 'compatible%';
  • show all 是 ksql 里最省事的查法,一次列出所有参数,翻一下就能看到 compatible_level 及其当前值。
  • 第二条直接查 sys_catalog.sys_settings,用 like 'compatible%' 把兼容相关参数一网打尽,还能顺带看到 setting、context(生效级别)等字段,判断这个参数是会话级还是实例级很方便。

补充(笔记里没写,属常用写法):如果只想看这一个值,直接 SHOW compatible_level; 或 SELECT current_setting('compatible_level'); 更快。


三、修改兼容模式:三种方式

方式一:启动参数 / 库级设置

kingbase -c compatible_level=oracle -D /opt/Kingbase/ES/V7/data
ALTER DATABASE <库名> SET compatible_level = 'oracle';
  • -c 是给服务进程传启动参数,-D 指定 data 目录,两者配套使用。
  • ALTER DATABASE 是库级设置,只对指定库生效,新连接才用得上新值。

⚠️ 笔记原文是速记写法 alter database set compatible_level =oracle;,直接粘进 ksql 会报语法错误——ALTER DATABASE 后面必须带库名,值建议加引号。

方式二:会话级 SET

SET compatible_level = 'oracle';

笔记里只写了占位形式:

SET 参数名称 = 参数值

展开就是上面那条 SET。它只影响当前会话,断开重连即恢复,适合临时验证「同一条 SQL 在 Oracle / MySQL 两种模式下分别怎么解析」,不要拿它当永久改模式用。

方式三:改 kingbase.conf(最常用、最持久)

笔记里先用 tail 看了配置文件尾部:

[kingbase@wgzx data]$ tail -10 /opt/Kingbase/ES/V7/data/kingbase.conf

尾部内容如下,最后一行就是显式设置的兼容模式:

#cs_loader_threadcount = 5
#cs_loader_thread_bufsize = 320
#---------------------------------------------------------------------------
# KLogMiner
#---------------------------------------------------------------------------
#enable logminer
#enable_llogminer=off
compatible_level = 'oracle'

要切到 MySQL 模式,把这一行的值换掉即可:

compatible_level = 'mysql'
  • 前面带 # 的都是注释掉的默认项,只有不带注释、显式写出的那一行才真正生效。
  • 值建议用单引号包起来,与笔记里的写法保持一致。
  • 改完配置文件 需要重启数据库,只用 reload 通常不够。

四、重启与验证:sys_ctl 怎么用

笔记里存了一份 sys_ctl --help 的输出,正好当速查:

sys_ctl 是一个启动,停止,重启,重载配置文件的工具,
汇报 Kingbase 服务器的状态,或者用信号通知 Kingbase 的进程。
使用:
  sys_ctl start   [-w] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
  sys_ctl stop    [-W] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
  sys_ctl restart [-w] [-D DATADIR] [-s] [-m SHUTDOWN-MODE] [-o "OPTIONS"]
  sys_ctl reload  [-D DATADIR] [-s]
  sys_ctl status  [-D DATADIR]
  sys_ctl kill    SIGNALNAME PID

实操就三步:

# 1)重启使配置生效
sys_ctl restart -D /opt/Kingbase/ES/V7/data

# 2)确认实例已起来
sys_ctl status  -D /opt/Kingbase/ES/V7/data
-- 3)重新连库,确认模式值
SHOW compatible_level;

为什么要 restart 而不是 reload:兼容模式牵涉 SQL 解析器、系统表与内置函数的默认行为,reload 只是重读配置文件,笔记里也明确写了「重启数据库查看」。生产环境请在变更窗口操作,并先确认应用连接的库是否就是改的这个库。


五、为什么搜到的都是 V8R6 / V9:一张版本对照表

这正是这次翻旧笔记的原因——新版的查法在 V8R3 上根本用不了。

对比项 V8R3(本文) V8R6 / V9
核心参数 / 模式 compatible_level database_mode
查看命令 show all、查 sys_settings(或 SHOW compatible_level) SHOW database_mode;
定模式时机 启动参数、库级、会话级、配置文件 初始化 / 安装时选定,initdb -m mysql
典型改法 改 kingbase.conf 后 sys_ctl restart 模式在初始化阶段确定,切换通常要重新初始化实例
大小写相关参数 show case_sensitive; V8R6 起 show enable_ci;

几个容易踩的点:

  • 在 V8R3 上执行 SHOW database_mode; 会提示参数不存在,不是数据库坏了,是版本不对。
  • 官方文档《KingbaseES V8R3 和 V8R6 兼容性》也提到,兼容开关可在 kingbase.conf、数据库初始化时、用户会话中 三处设置——正好对应笔记里的三种方式。
  • case_sensitive 与 enable_ci 语义相反:前者返回 on 表示大小写敏感,后者返回 on 表示大小写不敏感(ci = case insensitive)。迁移排查时最容易看反。

本节版本对照依据金仓官方文档、金仓社区体验官文章及官方 MySQL 兼容性白皮书整理,用于检索时快速区分;具体参数与行为请以对应版本的官方文档为准。


六、避坑清单

坑 表现 处理
拿新版命令查老库 SHOW database_mode; 报参数不存在 V8R3 用 compatible_level
ALTER DATABASE 漏库名 语法错误 补上 <库名>
直接执行占位写法 SET 参数名称 = 参数值 报错 展开成 SET compatible_level = 'oracle';
会话级 SET 当永久改 重连后模式又变回去 用启动参数 / 库级 / 配置文件
改完 conf 只 reload 模式没变化 sys_ctl restart 后重新连接验证
照抄 V7 路径 找不到 data 目录 按实际安装目录调整 -D
切 MySQL 忘改值 仍是 oracle 把 oracle 统一替换为 mysql
大小写参数看反 迁移后对象名报错 注意两个参数 on 的含义相反

七、命令速查表

目的 命令
查看全部参数 show all;
查兼容相关参数 select * from sys_catalog.sys_settings where name like 'compatible%';
只看当前模式 SHOW compatible_level;
启动时指定 kingbase -c compatible_level=oracle -D <data目录>
库级设置 ALTER DATABASE <库名> SET compatible_level = 'oracle';
会话级设置 SET compatible_level = 'oracle';
配置文件 compatible_level = 'oracle'(写入 kingbase.conf)
重启生效 sys_ctl restart -D <data目录>
查看状态 sys_ctl status -D <data目录>

八、写在最后

这份笔记写于 2020 年,躺在印象笔记里,后来换成语雀也没迁过来。命令谈不上多漂亮,甚至还有几处速记和占位符,但今天真有人问起 V8R3,它就能把答案捞回来。

技术笔记的价值,往往不在写得多工整,而在于隔了六年,你还能翻得到。

老版本资料越来越难搜,如果你手上也有还在跑 V8R3 的实例,建议把查看与修改方式存一份。有需要的小伙伴可收藏。


【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。