SQL Server 到 KingbaseES V9R4C12 的零改造迁移实战

后续插入、更新、删除操作均可通过界面或 SQL 窗口完成，体验接近原生 SQL Server。

3. 创建兼容库（Linux 系统）

KingbaseES 支持 Oracle、PostgreSQL 和 SQL Server 三种模式。针对本次迁移，指定创建 SQL Server 兼容库：

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

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

二、兼容性全景测试

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 ('体验官');

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

2. 语法糖支持

行级锁行为

-- 会话 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; -- 跳过被锁行

FOR XML 与 TOP

SELECT * FROM t3 FOR XML RAW, ROOT('root'); -- 支持 RAW/AUTO/EXPLICIT/PATH
SELECT TOP (3) WITH TIES * FROM t2 ORDER BY v; -- WITH TIES 同样支持

3. 存储过程与 T-SQL 细节

批处理分隔符 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

注意点：RAISERROR 语法完全一致，支持 WITH NOWAIT。THROW 同样可用，与 SQL Server 2012+ 行为一致。

此外，KingbaseES 对最后一个字段可加逗号的宽松语法也予以支持，这对老系统极其友好。

4. JDBC 兼容测试

Spring Boot + MyBatis 项目仅需修改连接串：

旧：jdbc:sqlserver://... 新：jdbc:kingbase8://...?compatibleMode=mssql

无一行 Java 代码改动。验证五种存储过程场景（无参数、IN/OUT 参数、返回值、更新计数）全部通过单元测试，MyBatis XML 中的 statementType="CALLABLE" 无需调整。

三、性能对比：TPCH 100G

1. 硬件规格

• 2 × Intel 6230R 26C52T
• 512 GB DDR4
• NVMe SSD 3.2 TB RAID0
• CentOS 7.9 + 关闭 NUMA

2. 测试结果摘要

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

四、踩坑与填坑

1. IDENTITY_INSERT 行为差异

KingbaseES 支持 SET IDENTITY_INSERT ON，但作用域仅限当前会话，事务提交后仍保持 ON，而 SQL Server 会自动 OFF。

解决：在存储过程末尾显式执行 SET IDENTITY_INSERT OFF。

2. 全文索引

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

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

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 还原，性能也能打平。对于背负合规压力的技术团队，这是一条可行的国产数据库替代最短路径。