零改造迁移实录：2000+存储过程从 SQL Server 迁移至 KingbaseES V9R4C12

（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 还原，性能也能打平。

关键字解说

1. 信创：全称'信息技术应用创新'，是国家主导的软硬件国产化替代工程。
2. 平替：'平滑替代'的口语化表达，指在不修改或极少修改业务代码的前提下，将国外数据库完整迁移到国产数据库。
3. AlwaysOn：SQL Server 2012+ 推出的高可用与灾难恢复方案。
4. KingbaseES：电科金仓自主研发的企业级关系型数据库，基于 PostgreSQL 内核深度改造。
5. V9R4C12：KingbaseES 2024 年发布的大版本号，C12 为 SQL Server 兼容特性包。
6. 存储过程：在数据库内预编译并持久化的一组 SQL/控制流语句。
7. 链接服务器：SQL Server 提供的分布式查询机制。
8. 兼容性验证：迁移前必须完成的工程步骤。
9. TPCH：Transaction Processing Performance Council 制定的决策支持基准。
10. CDC：Change Data Capture，通过解析事务日志把行级变更实时输出。
11. Debezium：Red Hat 开源的分布式 CDC 平台。
12. KStudio：Kingbase 官方图形化集成开发环境。
13. 灰度切换：上线策略，逐步放大流量直至 100% 切走旧库。
14. kdb_database_link：KingbaseES 内置的跨库访问扩展。
15. kdb_text：KingbaseES 全文检索扩展。