金仓数据库 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 的实例,建议把查看与修改方式存一份。有需要的小伙伴可收藏。
- 点赞
- 收藏
- 关注作者
评论(0)