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

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

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

一、为什么要“平替”

过去十年，我们团队的核心业务一直跑在 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 下载与安装

（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 /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 = -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] 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 TRY
    INSERT INTO t1(id) VALUES (1/0);
END TRY
BEGIN 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 结果摘要（单位：秒）

结论：两者互有胜负，整体差距在 ±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。

六、割接方案与回退策略

七、写在最后

如果你也在寻找一条 低成本、低风险、周期短 的 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. 灰度割接：按权重逐步切换流量、零回滚窗口的上线策略。