网站导航
> 技术文档 > 从 SQL Server 到 KingbaseES V9R4C12，一次“无痛”迁移与深度兼容体验实录

从 SQL Server 到 KingbaseES V9R4C12，一次“无痛”迁移与深度兼容体验实录

网友: 技术文档 2025-07-26 19:47:38

#数据库平替用金仓 #金仓产品体验官

摘要：本文以体验项目案例为主线，从下载安装、数据类型、T-SQL、JDBC、性能基准、踩坑回退六大维度，全景验证 KingbaseES V9R4C12 对 SQL Server 的“零改造”兼容承诺；并给出 TPCH 100G 性能对比与灰度割接方案，为信创替换提供可复制的落地指南。

目录

一、为什么要“平替”

二、30 分钟完成部署

2.1 下载与安装

2.2 金仓数据库开发工县KStudio

2.3 创建兼容库（Linux系统）

三、兼容性全景测试

3.1 特殊数据类型“一把梭”

3.2 语法糖：NOWAIT、SKIP LOCKED、FOR XML、TOP

3.2.1 行级锁行为

3.2.2 FOR XML

3.2.3 TOP 子句

3.3 存储过程与 T-SQL 细节

3.3.1 批处理 GO、PRINT、RAISERROR

3.3.2 “最后一个字段可加逗号”

3.4 JDBC 兼容测试

四、性能对比：TPCH 100G

4.1 硬件规格

4.2 测试方法

4.3 结果摘要（单位：秒）

五、踩坑与填坑

5.1 “IDENTITY_INSERT” 行为差异

5.2 全文索引

5.3 链接服务器

六、割接方案与回退策略

七、写在最后

一、为什么要“平替”

过去十年，我们团队的核心业务一直跑在 SQL Server 2016/2019 双节点 AlwaysOn 集群上。随着国央企信创节奏加快，继续留在 Windows + SQL Server 技术栈不仅面临合规风险，License 费用也逐年攀升。经过多轮 PoC，我们把目光锁定在 KingbaseES V9R4C12（SQL Server 兼容版）——官方宣称“数据库平替用金仓”，推出低风险迁移方案，这些对背负 2000+ 存储过程、300+ 链接服务器的系统来说，诱惑力极大。

本文记录了一次“从下载到上线”的完整旅程：

1.部署安装

2.兼容性验证（数据类型、T-SQL、接口、工具链）

3.性能对比

4.踩坑与填坑

5上线割接方案

二、30 分钟完成部署

2.1 下载与安装

金仓官网下载：https://www.kingbase.com.cn/download.html#database

（1）Windows下载与安装：

本文主要针对Windows系统进行体验测试，分享给大家一起交流学习！打开上面金仓官网地址，然后筛选 V9R4C12(SQLServer兼容版)，如下图所示

然后选择 X64_Windows（如下图所示）

下面就开始下载，下载完成虎双击打开文件（如下图所示）

然后会自动跳转到下面这个驱动器，点击KINGBSASE.EXE然后开始安装（如下图所示）

接下来就来到安装程序图，如下图所示，点击下一步

1.简介，点击接受然后下一步（如下图）

2.许可协议，新手建议完全安装（如下图所示）

3.选择安装集，选择想要安装的位置，如下图我选择安装在E盘上

4.选择安装文件夹，安装（如下图所示）

5.预安装摘要、添加功能、选择安装集，系统自动安装，如下图所示：

6.正在安装，选择一个文件夹，用于存储数据的，改文件夹必须为空（如下图所示）

7.选择文件夹，数据库默认端口号：54321，用户名：system，然后输入对应的密码（如下图）

到这里就完成了Windows数据库的初始化工作！

（2）Linux下载与安装：

官方下载页提供了 Linux x86_64 一键 tar 包 与 Windows GUI 安装向导。如下图所示，点击下载

下载后如下图所示，通过ftp方式上传到Linux服务器上进行安装

 

# 1. 创建 kingbase 用户useradd kingbase && echo \'kingbase ALL=(ALL) NOPASSWD:ALL\' >> /etc/sudoers# 2. 解压tar -xzf kingbasees_v9r4c12_linux_x64.tar.gz -C /optchown -R kingbase:kingbase /opt/kingbase# 3. 初始化实例su - kingbase/opt/kingbase/install/initdb -D /data/kingbase -E UTF8 --locale=zh_CN.UTF-8/opt/kingbase/install/kingbase -D /data/kingbase > kingbase.log 2>&1 &

2.2 金仓数据库开发工县KStudio

打开刚才安装的工具Kstudio，如下图所示

新建连接，注意密码是刚才上面安装设置的密码，我这里刚才设置是：qwertyuiop123456

点击测试连接，提示连接成功，如下图：

 

（1）新建数据库

CREATE DATABASE [xiaoxiang] WITH OWNER = [system] ENCODING \'UTF8\' TEMPLATE [template1] TABLESPACE = [sys_default] lc_collate = \'zh_CN.UTF-8\' lc_ctype = \'zh_CN.UTF-8\' connection_limit = -1 allow_connections = TRUE is_template = FALSE;ALTER DATABASE [xiaoxiang] COLLATE Chinese_PRC_CI_AI;

 （2）新增表

CREATE TABLE [public].[title] ( [id] integer IDENTITY( 1, 1 ) NOT NULL, [title] varchar(128), [description] varchar(512));ALTER TABLE [public].[title] SETTABLESPACE [sys_default];

（3）插入数据库，可以手动写sql，也可以界面操作，非常方便

INSERT INTO [public].[title]([id], [title], [description])VALUES(2, \'电科金仓2025发布会\', \'电科金仓2025.07.15在北京举行发布会\');

（4）修改表数据

UPDATE [public].[title]SET [id]=2, [title]=\'电科金仓2025发布会-通知2\', [description]=\'电科金仓2025.07.15在北京举行发布会2\';

（5）删除表数据

 

DELETE FROM [public].[title]WHERE [id]=2 AND [title]=\'电科金仓2025发布会-通知2\' AND [description]=\'电科金仓2025.07.15在北京举行发布会2\';

 

2.3 创建兼容库（Linux系统）

KingbaseES 可以同时创建 Oracle 模式、PostgreSQL 模式 和 SQL Server 模式 三种库。这里指定：

-- 通过 ksql 连接CREATE DATABASE ss_app DBCOMPATIBILITY=\'mssql\';\\c ss_app

注：DBCOMPATIBILITY 参数只能在建库时指定，后续不可修改。

三、兼容性全景测试

3.1 特殊数据类型“一把梭”

SQL Server 的 ROWVERSION/TIMESTAMP、SQL_VARIANT、UNIQUEIDENTIFIER、SYSNAME 在 KingbaseES 中都有直接映射，测试脚本如下：

-- 1. ROWVERSIONCREATE TABLE t1 ( id INT PRIMARY KEY, rv ROWVERSION);-- 插入测试INSERT INTO t1(id) VALUES (1),(2);SELECT * FROM t1;-- rv 字段自动递增，行为与 SQL Server 完全一致-- 2. SQL_VARIANTCREATE TABLE t2 ( v SQL_VARIANT);INSERT INTO t2 VALUES (123), (\'abc\'), (GETDATE());SELECT v, SQL_VARIANT_PROPERTY(v,\'BaseType\') AS BaseType FROM t2;-- 3. UNIQUEIDENTIFIER & NEWSEQUENTIALID()CREATE TABLE t3 ( gid UNIQUEIDENTIFIER DEFAULT NEWSEQUENTIALID() PRIMARY KEY, name SYSNAME);INSERT INTO t3(name) VALUES (\'体验官\');SELECT * FROM t3;

结论：所有类型均可直接替换，无需改写。

3.2 语法糖：NOWAIT、SKIP LOCKED、FOR XML、TOP

3.2.1 行级锁行为
-- 会话 ABEGIN TRAN;UPDATE t1 SET id = id WHERE id = 1;-- 会话 BSELECT * FROM t1 WHERE id = 1 NOWAIT; -- 立即报错SELECT * FROM t1 WHERE id = 1 SKIP LOCKED; -- 跳过被锁行
3.2.2 FOR XML
SELECT * FROM t3 FOR XML RAW, ROOT(\'root\');

KingbaseES 支持 RAW、AUTO、EXPLICIT、PATH 四种模式，输出与 SQL Server Management Studio 结果一致。

3.2.3 TOP 子句
SELECT TOP (3) WITH TIES * FROM t2 ORDER BY v;

WITH TIES 也支持，惊喜。

3.3 存储过程与 T-SQL 细节

3.3.1 批处理 GO、PRINT、RAISERROR
PRINT N\'开始同步...\';BEGIN TRY INSERT INTO t1(id) VALUES (1/0);END TRYBEGIN CATCH RAISERROR(\'同步失败：%s\', 16, 1, ERROR_MESSAGE());END CATCH;GO -- 批处理分隔符PRINT \'完成\';

注意点：

  • RAISERROR 语法完全一致，支持 WITH NOWAIT。

  • THROW 同样可用，与 SQL Server 2012+ 行为一致。

3.3.2 “最后一个字段可加逗号”
CREATE TABLE t4 ( a INT, b INT, -- 这里多了个逗号);

KingbaseES 不会报错，对老系统极其友好。

3.4 JDBC 兼容测试

我们原来的 Spring Boot + MyBatis 项目，连接串从

jdbc:sqlserver://...

改成

jdbc:kingbase8://...?compatibleMode=mssql

即可，无一行 Java 代码改动。

验证五种存储过程场景：

  1. 无参数

  2. IN 参数

  3. OUT 参数

  4. 返回值

  5. 更新计数

全部通过单元测试，MyBatis XML 中的 statementType=\"CALLABLE\" 无需调整。

四、性能对比：TPCH 100G

4.1 硬件规格

  • 2 × Intel 6230R 26C52T

  • 512 GB DDR4

  • NVMe SSD 3.2 TB RAID0

  • CentOS 7.9 + 关闭 NUMA

4.2 测试方法

  • SQL Server 2019 企业版（无补丁）

  • KingbaseES V9R4C12（mssql 模式）

  • TPCH 100G 数据，表结构、索引脚本完全一致

4.3 结果摘要（单位：秒）

Query SQL Server KingbaseES 差异 Q1 28.4 26.9 -5% Q5 42.1 44.3 +5% Q9 118.7 115.2 -3% Q21 210.9 205.4 -3%

结论：两者互有胜负，整体差距在 ±5% 以内，可视为同一梯队。

五、踩坑与填坑

5.1 “IDENTITY_INSERT” 行为差异

KingbaseES 支持 SET IDENTITY_INSERT ON，但作用域仅限当前会话，事务提交后仍保持 ON，而 SQL Server 会自动 OFF。
解决：在存储过程末尾显式 SET IDENTITY_INSERT OFF。

5.2 全文索引

SQL Server 的 CONTAINS/CONTAINSTABLE 默认启用；KingbaseES 需安装 kdb_text 扩展并手动创建词典。
解决：

CREATE EXTENSION kdb_text;-- 创建中文分词配置

5.3 链接服务器

KingbaseES 提供 kdb_database_link 扩展，可连接 SQL Server、Oracle、MySQL。

CREATE EXTENSION kdb_database_link;SELECT dblink_connect(\'conn\', \'sqlserver://user:pwd@host:1433/db\');

实测分布式查询性能损耗 <10%，已用于 ETL。

六、割接方案与回退策略

阶段 动作 时间窗口 回退方案 全量迁移 使用 SSDT + Kingbase Migration Toolkit 4 h 原 SQL Server 只读 增量同步 基于 CDC + Debezium 实时同步 持续 一键切换回 DNS 灰度验证 20% 流量到 KingbaseES 1 周 流量权重回退 全量切换 100% 流量 0.5 h 回滚 DNS + 连接池

七、写在最后

如果你也在寻找一条 低成本、低风险、周期短 的 SQL Server 信创路线，KingbaseES V9R4C12 值得认真评估。它并不是“阉割版”兼容，而是把 SQL Server 常用语法、类型、接口、工具链几乎 1:1 还原，性能也能打平。

10 个关键字解说：

  1. KingbaseES：人大金仓企业级关系型数据库，本文体验版本 V9R4C12。

  2. SQL Server兼容版：KingbaseES 专用模式，语法、类型、接口与 SQL Server 对齐。

  3. DBCOMPATIBILITY：建库参数，设置 mssql 即启用兼容模式。

  4. ROWVERSION：SQL Server 时间戳类型，KingbaseES 原生支持并自动维护。

  5. FOR XML：SQL Server 结果集转 XML 语法，KingbaseES 支持 RAW/AUTO/PATH 四种。

  6. RAISERROR：T-SQL 错误处理语句，兼容 SQL Server 级别与 NOWAIT 选项。

  7. kdb_database_link：金仓插件，实现跨库、跨异构实例的联邦查询。

  8. NEWSEQUENTIALID：生成顺序 GUID 的函数，迁移后无需改写主键策略。

  9. TPCH 100G：标准化决策支持基准，用于性能横向对比。

  10. 灰度割接：按权重逐步切换流量、零回滚窗口的上线策略。

本文相关链接推荐：

1、【金仓数据库征文】政府项目数据库迁移：从MySQL 5.7到KingbaseES的蜕变之路

2、【金仓数据库征文】学校AI数字人：从Sql Server到KingbaseES的数据库转型之路

3、电科金仓2025发布会，国产数据库的AI融合进化与智领未来

4、国产数据库逆袭：老邓的“六大不敢替”被金仓逐一破解

5、《一行代码不改动！用KES V9 2025完成SQL Server → 金仓“平替”迁移并启用向量检索》

6、《赤兔引擎×的卢智能体：电科金仓如何用“三骏架构”重塑AI原生数据库一体机》

网络标签：

相关问题