零改造迁移实录：2000+存储过程从SQL Server滑入KingbaseES V9R4C12的72小时

摘要：在信创窗口期，我们把拥有2000+存储过程、300+链接服务器的核心业务，从 SQL Server 2016/2019 平移到 KingbaseES V9R4C12（SQL Server 兼容版）。本文以 30 分钟部署、TPCH 100G 性能 PK、真实踩坑修复、灰度割接 4 小时完成的全过程，给出一条“零改造代码、零业务中断、零 License 费用”的国产数据库替代最短路径，供同样背负合规压力的技术团队参考。

一、为什么要“平替”

二、Windows与Linux安装部署

2.1 下载与安装

2.1.1 Windows下载与安装：

2.1.2 Linux下载与安装：

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上线割接方案

二、Windows与Linux安装部署

2.1 下载与安装

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

2.1.1 Windows下载与安装：

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

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

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

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

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

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

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

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

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

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

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

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

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

2.1.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 /opt
chown -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 = -1allow_connections = TRUEis_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] SET
TABLESPACE [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. ROWVERSION
CREATE TABLE t1 (id INT PRIMARY KEY,rv ROWVERSION
);-- 插入测试
INSERT INTO t1(id) VALUES (1),(2);
SELECT * FROM t1;
-- rv 字段自动递增，行为与 SQL Server 完全一致-- 2. SQL_VARIANT
CREATE 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 行级锁行为

-- 会话 A
BEGIN TRAN;
UPDATE t1 SET id = id WHERE id = 1;-- 会话 B
SELECT * 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 TRYINSERT INTO t1(id) VALUES (1/0);
END TRY
BEGIN CATCHRAISERROR('同步失败：%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 代码改动。

验证五种存储过程场景：

无参数
IN 参数
OUT 参数
返回值
更新计数

全部通过单元测试，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 还原，性能也能打平。

15 个关键字解说：
1. 信创
全称“信息技术应用创新”，是国家主导的软硬件国产化替代工程，要求核心系统逐步脱离国外产品，实现供应链安全与合规。

2. 平替
“平滑替代”的口语化表达，指在不修改或极少修改业务代码、不中断服务的前提下，将国外数据库完整迁移到国产数据库。

3. AlwaysOn
SQL Server 2012+ 推出的高可用与灾难恢复方案，通过同步或异步副本实现读写分离、秒级故障转移，是企业级架构的核心支柱。

4. KingbaseES
电科金仓自主研发的企业级关系型数据库，基于 PostgreSQL 内核深度改造，支持 Oracle、SQL Server、MySQL 多兼容模式，具备国产密码算法与可信计算能力。

5. V9R4C12
KingbaseES 2024 年发布的大版本号，其中 V9 代表内核世代，R4 为第四次功能增强，C12 为 SQL Server 兼容特性包，可直接解析 T-SQL 语法。

6. 存储过程
在数据库内预编译并持久化的一组 SQL/控制流语句，可接受参数、返回结果集，减少网络往返、提升复杂业务性能，是大型系统的粘合剂。

7. 链接服务器
SQL Server 提供的分布式查询机制，通过 OLE DB/ODBC 把异构数据库（Oracle、MySQL、文件）映射为本地“服务器”，实现跨实例 JOIN。

8. 兼容性验证
迁移前必须完成的工程步骤：逐一比对数据类型、系统函数、锁行为、错误码、驱动接口，确保应用在新库上的行为与原库 100% 一致。

9. TPCH
Transaction Processing Performance Council 制定的决策支持基准，包含 8 张表、22 条复杂查询，用于衡量 OLAP 场景下 100 GB~100 TB 的性能。

10. CDC
Change Data Capture，通过解析事务日志把行级变更（INSERT/UPDATE/DELETE）实时输出到 Kafka、Debezium 等消息流，实现增量同步。

11. Debezium
Red Hat 开源的分布式 CDC 平台，支持 SQL Server、MySQL、Oracle、PostgreSQL，可把事务日志转为 JSON 事件流，供下游系统实时消费。

12. KStudio
Kingbase 官方图形化集成开发环境，集成 SQL 编辑器、对象管理、性能监控、迁移向导，可一键替换 SQL Server Management Studio。

13. 灰度切换
上线策略：先让 1%~20% 的只读流量或边缘业务访问新库，通过监控指标、错误日志确认稳定后，再逐步放大流量，直至 100% 切走旧库。

14. kdb_database_link
KingbaseES 内置的跨库访问扩展，语法与 SQL Server 链接服务器对齐，可透明访问 Oracle、MySQL、SQL Server 远程表，支持分布式事务。

15. kdb_text
KingbaseES 全文检索扩展，支持中文分词、同义词、权重排序、高亮片段，补全 SQL Server CONTAINS/FREETEXT 功能，迁移无需改查询逻辑。

本文相关链接推荐：

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

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

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

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

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

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

7、探秘KingbaseES在线体验平台：技术盛宴还是虚有其表？

8、破除“分布式”迷思：回归数据库选型的本质