编程 KingbaseES 的 db_mode 只有 4 个取值,initdb 时定死——选错后驱动、连接串、迁移工具会接连报错

2026-11-22 00:04:00

KingbaseES 的 db_mode 只有 4 个取值,initdb 时定死——选错后驱动、连接串、迁移工具会接连报错

区别 #8335 的 sys_anon 脱敏切面。

结论:db_mode 是初始化实例时的参数,取值只有 pg / oracle / mysql / sqlserver 四选一,默认端口 54321。它写死在 initdb / 建库阶段,运行期没有切换开关;模式一旦选错,驱动类、连接串、框架方言、Liquibase changelog、迁移工具全都要跟着改;实在改不动,就只能重建实例再做 dump/restore 或 SQL 移植。

信源:KingbaseES V9 官方手册(help.kingbase.com.cn/v9/,版本说明书 /v9/intro/releasenotes-external-v9/、应用迁移流程 /v9/development/develop-transfer/transplant-heteroid/transplant-heteroid-3.html)与电科金仓 C010 版发布说明、社区部署记录。官网 www.kingbase.com.cn,下载页 www.kingbase.com.cn/download.html,文档站 docs.kingbase.com.cn。

先把版本对上,再谈模式

V009R001C001B0014 拆开是 V9 / R1 / C1 / B14。当前全平台版是 V009R001C010(2025-08 发布),这一版新增了 SQL Server 兼容模式,所以兼容模式一共四种:Oracle、MySQL、SQL Server、PostgreSQL。更早的 V9 子版本只有前三种,看到“SQL Server 兼容”字样先确认版本对得上。

模式在初始化实例时用 db_mode 指定,默认端口 54321。模式在建库 / initdb 阶段确定,改模式等于重建实例 + dump/restore 或 SQL 移植——没有别的路径。

驱动是两套,选错直接起不来

两套驱动都躺在 $KINGBASE_HOME/Interface/jdbc 目录下。

ES 形态:

  • 驱动类 com.kingbase8.Driver
  • jar 文件名 kingbase8-9.0.0.jar(JDK1.8),另有 kingbase8-9.0.0.jre6.jar、kingbase8-9.0.0.jre7.jar

PG 形态:

  • 驱动类 org.postgresql.Driver
  • 连接串 jdbc:postgresql://localhost:54321/test
  • 驱动包 postgresql-42.2.9.jar

框架侧官方给的做法统一走 pg 形态:Flyway、Liquibase、Activiti 都直接用 pg 驱动与 pg 连接串。Activiti 要在 activiti.cfg.xml 里配 jdbcDriver=org.postgresql.Driver、jdbcUrl=jdbc:postgresql://localhost:54321/test、databaseSchemaUpdate=true;Spring 场景 database type 指定 postgres、database schema update=false,同时数据库实例要配成大小写不敏感,工作流库建在默认 schema 下。(以上为手册写法,未实测)

Liquibase 有个具体的坑:建带 blob/clob 属性的表时,不能用 liquibase 的 column type 属性指定类型,否则 blob 被映射成 oid、clob 被映射成 text;必须在 changelog 里用 `` 标签直接写建表 DDL。(未实测)

Python 侧同理:ES 形态用 ksycopg2,连接串按 dbname / user / password / host / port 格式写,端口 54321;PG 形态用 psycopg2。

排查顺序:现象 → 判据 → 边界

现象:应用起不来,报找不到驱动类;或者能连上但类型映射不对(blob 落成 oid、clob 落成 text);或者 SQL 一跑就在函数、分页、日期格式上不认。

判据:按顺序核三样——实例的 db_mode 到底是 pg / oracle / mysql / sqlserver 哪一个;classpath 里挂的是 com.kingbase8.Driver 还是 org.postgresql.Driver;连接串是不是 jdbc:postgresql:// 开头。三样里有一项对不上,先改配置,别急着改代码。

边界:db_mode 在 initdb 阶段确定,运行期没有等价的手段能改。模式不对不能靠换连接串绕过,只能重建实例 + dump/restore 或按 SQL 移植。反过来,模式对、驱动也对,类型仍然错,才轮到查框架方言和 changelog 写法。

版本之间的兼容线

V008R002 / R003 / R004 / R006 升到 V9,数据文件不兼容,dump/restore 也不兼容,官方要求依赖 SQL 做移植——内核升级后文件存储结构、备份还原依赖的系统表都变了。

V9 内部小版本之间(比如 C002B0014 → C010)可以用 sys_upgrade 在线升级,业务停机分钟级(未实测)。V8 早期版本走的是滚动升级方案。

迁移工具链怎么串

  • KDMS / KES DMS:在线兼容性评估,扫 schema、存储过程、触发器、视图,出兼容性报告并自动生成转换脚本。
  • KDTS:全量离线迁移,支持 Oracle、SQL Server、MySQL、DB2、Sybase、GBase8s、神通等数据源,支持二次迁移重跑失败 SQL。
  • KFS:基于源库日志捕获增量,做在线追平。
  • KDTS + KFS:组合用于不能停机的在线迁移。

割接做法:原系统断网不关机,留出快速回退的路;最终数据同步后新系统上线;观察期建议覆盖三个完整业务周期以上。

应用层能省的和不能省的

手册原文也承认:应用层面 JDBC/ODBC 迁移通常只需替换驱动与连接串,这部分工作量不大。不能低估的是存储过程 / 函数的改造。社区列出的 MySQL 差异包括:NOW() 换 CURRENT_TIMESTAMP、DATE_FORMAT() 换 TO_CHAR()、自增主键换序列。这类改写不会在连接串上暴露,只会在业务真正跑起来的时候报错。

推荐文章

程序员茄子在线接单