先聊聊背景

去年我手里接了个政务系统的国产化替换项目，客户硬是要把数据库换成金仓。 团队里没人碰过金仓，心里dou打鼓。 说实话，我也是第一次听说 KingbaseES。 那种“必须用国产”情绪，你懂的，挺让人压力山大的。

第一步，先把金仓的 JDBC 驱动放进 Maven。 别跟我说找不到坐标，我Yi经踩坑了好几次。 正确的 groupId 是 cn.com.kingbase，artifactId 用 kingbase8，版本号随你们公司内部库Zui新的就行。 记得驱动类名是 com.kingbase8.Driver，不是 com.kingbase.Driver，不对不对，是我之前写错了。

    cn.com.kingbase
    kingbase8
    8.6.1


    org.mybatis
    mybatis
    3.5.13


    com.github.pagehelper
    pagehelper
    5.3.2

接下来在 resources 目录新建个 jdbc.properties 把四件套写进去：驱动、URL、用户名、密码。 URL 的格式是 jdbc:kingbase8://HOST:PORT/DBNAME，记得后面Ke以加点参数提升性Neng，比如 &useServerPrepStmts=true&rewriteBatchedStatements=true。

jdbc.driver=com.kingbase8.Driver
jdbc.url=jdbc:kingbase8://127.0.0.1:54321/testdb?useServerPrepStmts=true&rewriteBatchedStatements=true
jdbc.username=system
jdbc.password=123456

哈，这样子配完以后用 Druid 或者 Hikari dou行，我这里直接用了 MyBatis 自带的 POOL。

这一步Zui关键，因为金仓兼容 Oracle 和 MySQL 两种模式，要把写对才不会跑出奇怪的 SQL。 Ru果你想用 LIMIT 分页，就在 URL 后面加上 ?KingbaseMode=mysql；不加默认是 Oracle 模式，用 rownum。

    
    
        
        
        
    
    
        
            k​ingbase8
            ifNotEmpty=&&&&&
        
    
    
        environment id="dev"
            transactionManager type="JDBC"/>
            dataSource type="POOLED"
                property name="driver" value="${jdbc.driver}"/>
                property name="url" value="${jdbc.url}"/>
                property name="username" value="${jdbc.username}"/>
                property name="password" value="${jdbc.password}"/>
            
        
    
    
    

别忘了把上面的 `` 标签里的属性名改成小写，否则 MyBatis 会报错——这个坑我以前被坑了一天。

IAppMapper 用注解直接写 SQL，适合 CRUD 那种单表操作。哈哈，一行代码搞定增删改查。

package com.kingbase.mapper;
import com.kingbase.pojo.App;
import org.apache.ibatis.annotations.*;
import java.util.List;
public interface IAppMapper {
    @Insert VALUES")
    Integer insertApp;
    @Delete
    Integer deleteApp;
    @Update
    Integer updateApp;
    @Select
    @Results({
        @Result,
        @Result
    })
    List selectApps;
}

COPY 完以后你会发现实体类属性名字跟表字段大小写对应不上时会报错——这时候要么在实体上加 `@Table`，要么在 DB 建表时全小写走起。

Ru果业务里有联表、多条件过滤，那建议走 XML，把 SQL 写得清晰明白。下面给你一个Zui基础的模板：

    insert id="insertUser" parameterType="complex.pojo.User">">
        INSERT INTO test_user VALUES
   ...
   ...
   // 分页查询示例，用 LIMIT
   SELECT id, name FROM test_user
   ORDER BY id
   LIMIT #{offset}, #{pageSize}

PageHelper 在 MySQL 模式下Neng自动把 `LIMIT` 拼进去。只要在 Service 层这样包一下：

PageHelper.startPage;
List list = userMapper.selectUsers;
PageInfo pageInfo = new PageInfo<>;
System.out.println);

AOP 的方式也Ke以但咱们这儿懒得折腾，只要记得每次分页前调用一次 `startPage` 就行。

表名大小写敏感： 金仓默认区分大小写。Ru果你创建表时用了大写字母，却在 Mapper 里用了小写，就会出现 “relation does not exist”。解决办法就是在建表时全小写或者在 SQL 前后加双引号。

ID 类型： hen多同事习惯用 `int` 或者 `bigint`，其实金仓的 `number` geng通用。不过别忘了对应实体类的包装类型 Long/Integer，否则会出现类型转换异常。

PAGINATION 错误： Ru果你把 `helperDialect` 写成 `mysql`，页面会报 “unsupported dialect”。记得改成 `kingbase8`。不对不对，我刚才kan文档发现新版 PageHelper Yi经支持直接识别 driver，无需显式配置，不过老版本还是手动填吧。

Druid 与 KingBase 的兼容性： 有同事反馈 Druid 的监控页面报错，这是因为 Druid 默认检查 connectionUrl 中是否包含 “oracle” 或 “mysql”。只要在 Druid 配置里关闭 filterClassNames 或者自行添加自定义过滤器即可。

Lob 字段读写： 金仓对 CLOB/BLOB 的处理稍微有点麻烦，需要使用流方式读取。我当时试了半天才发现只要在 Mapper 方法上加 `` 并指定 `` 就Neng正常返回字符串。

#1 创建实体类 #2 编写 Mapper #3 写一个 JUnit 测试，把库删掉重新建表，然后跑增删改查和分页验证一下。下面贴一段简化后的测试代码：

public class KingBaseTest {
    private SqlSessionFactory sqlSessionFactory;
    @Before
    public void setUp throws IOException {
        Reader reader = Resources.getResourceAsReader;
        sqlSessionFactory = new SqlSessionFactoryBuilder.build;
        reader.close;
        try ) {
            Statement stmt = session.getConnection.createStatement;
            stmt.execute;
            stmt.execute)");
            stmt.close;
            session.commit;
        }
    }
    @Test
    public void crudAndPage throws Exception {
        try ) {
            IUserMapper mapper = session.getMapper;
            // 插入10条数据
            for  {
                mapper.insertUseri,"user"+i));
            }
            // 删除第1条
            mapper.deleteUser;
            // geng新第2条名字
            mapper.updateUser);
            // 查询全部
            List all = mapper.selectUsers;
            all.forEach;
            // 分页查询 第1页，每页5条
            PageHelper.startPage;
            List page = mapper.selectUsers;
            System.out.println;
            session.commit;
        }
     }
}

# 那么跑通之后你会kan到控制台打印出插入的数据以及分页后的前五条记录——恭喜，你Yi经成功把 MyBatis 连进了金仓！哈哈，有没有一种开挂的感觉？咱就是说这一步完成后后面的业务开发基本就是普通 MyBatis 开发，只需要注意大小写和即可。

* 换驱动hen容易踩坑——一定要核对 groupId 与 artifactId； * URL 参数别忘记加 KingbaseMode； * 表名大小写Zui好统一全小写，加双引号虽然Neng解决但太麻烦； * 分页插件必须是 kingbase8，不然生成的 SQL 会炸； * 注解方式适合单表 CRUD，XML geng适合复杂业务； * 多线程批量插入请打开 rewriteBatchedStatements 参数，可提升十几倍性Neng。

SAY GOOD LUCK！Ru果还有啥奇怪报错或者想聊聊实际项目中的细节，欢迎留言哈~咱们一起吐槽一起成长！😁