MariadbDriver —— 原生驱动程序

作者:仓颉技术交流平台官方
分类:数据库与存储 / 关系型数据库驱动

MariaDB驱动,适配MySQL、TiDB、OceanBase数据库。

2025-11-19
17

mariadb-driver是一个完全使用 仓颉编程语言​ 编写的、遵循 MariaDB/MySQL 协议的原生数据库驱动程序。作为连接仓颉应用生态与主流关系型数据库的关键桥梁,本项目不仅提供了基础的数据库操作能力,更在兼容性、可靠性、安全性易用性上进行了深度优化,旨在成为仓颉开发者进行数据持久化操作的首选方案。

核心维度分析

1. 广泛的数据库兼容性

本驱动深度兼容实现了 MySQL 客户端/服务器协议,使其具备了强大的多数据库支持能力,一套代码即可应对多种数据存储场景。

数据库类型

支持状态

说明

MariaDB

✅ 原生支持

主要适配和测试对象

MySQL

✅ 完全兼容

与 MariaDB 协议高度一致

TiDB

✅ 完全兼容

高度兼容 MySQL 协议的分布式数据库

OceanBase

✅ 完全兼容

高度兼容 MySQL 协议的金融级分布式数据库

2. 规范化的接口设计

严格遵循仓颉语言官方的 std.database.sql接口规范,确保了与仓颉标准生态的无缝集成,并为上层 ORM 框架(如 CORM)提供了坚实的底层支持。

3. 企业级核心功能

提供了一套完整、可靠的数据访问能力栈,满足从简单查询到复杂事务的各种业务需求。

功能模块

描述

连接管理

支持带连接池的数据源,可配置超时、大小、保活等参数

SQL 执行

支持 PreparedStatement,有效防止 SQL 注入,提升性能

事务控制

提供完整的事务生命周期管理(BEGIN, COMMIT, ROLLBACK

高级事务

支持 XA 分布式事务,满足复杂业务场景

数据类型

全面覆盖常用数据类型(整型、浮点、字符串、日期时间、Decimal等)

SSL/TLS

支持加密连接,保障数据传输安全

4. 灵活的连接配置

通过丰富的连接参数,您可以精细地控制驱动行为,以适应不同的部署环境和安全要求。

核心连接参数表示例:

参数分类

参数名

描述

默认值

认证

username, password

数据库用户名和密码

-

网络

host, port, database

数据库地址、端口和默认库

localhost, 3306

连接池

pool.max.size

连接池最大大小

10

pool.connection.timeout

获取连接超时(秒)

30

安全

ssl.mode

SSL 加密模式(如 required, verify_ca

preferred

ssl.ca, ssl.cert, ssl.key

SSL 证书路径

-