ZeosLib:Pascal/Delphi 世界的数据库访问瑞士军刀
引言
在 Delphi 和 Free Pascal 的生态圈里,数据库访问组件的选择其实并不算多。官方提供的 dbExpress 逐渐式微,FireDAC 虽然功能强大但仅限 Delphi 且收费,而 ZeosLib(Zeos Database Objects,简称 ZDBC)则以开源、跨编译器、跨数据库的姿态,成为许多 Pascal 开发者手中不可或缺的工具。
本文就来系统地介绍一下这个项目,包括它的定位、架构、支持的数据库、使用方式以及一些实战经验。
什么是 ZeosLib
ZeosLib 是一套原生的数据库访问组件库,专为 Delphi 和 Free Pascal 设计。它的项目主页位于 https://github.com/frones/ZeosLib,由早期的 SourceForge 时代延续至今,如今在 GitHub 上活跃维护。
它的核心目标很明确:用一套统一的 API,访问尽可能多的数据库系统。而且这套 API 是纯 Pascal 实现的,不依赖任何外部客户端库的 C 接口绑定(部分数据库除外,取决于连接方式),也不需要中间件。
主要特性
- 跨编译器:同时支持 Delphi 7 一直到最新的 Delphi 版本,以及 Free Pascal / Lazarus。
- 多数据库支持:MySQL、MariaDB、PostgreSQL、SQLite、Firebird、Interbase、Oracle、MSSQL、Sybase、DB2、ODBC、ASA 等。
- 原生协议实现:对 MySQL、PostgreSQL、Firebird、SQLite 等,Zeos 直接实现数据库的通信协议,无需安装客户端库。
- Dataset 与连接池:提供
TZConnection、TZQuery、TZTable、TZStoredProc等组件,与原生TDataSet体系高度兼容。 - 事务与参数化查询:完整支持参数化语句、事务控制、批量执行等。
- Unicode 支持:新版本全面支持 Unicode(UTF-8 传输层)。
- 线程安全考虑:支持多线程场景下的连接管理,配合连接池使用。
项目架构概览
ZeosLib 从代码结构上看,可以划分为几个层次(在仓库的 src 目录下):
src/ ├── core/ -- 核心框架:ZDBC 抽象接口、连接、语句、结果集、事务 ├── dbc/ -- 各数据库驱动实现(ZDBCMySql、ZDBCPostgreSql...) ├── component/ -- VCL/LCL 组件封装(TZConnection、TZQuery 等) ├── plain/ -- 纯接口层(不依赖 TDataSet,可直接用对象编程) ├── parsedb/ -- 数据库元数据解析 └── ...
1. 核心抽象层(ZDBC)
这是整个库的心脏。它定义了一套数据库无关的接口:
IZConnection:连接抽象IZStatement:SQL 语句抽象IZResultSet:结果集抽象IZTransaction:事务抽象
这一层的设计思路和 JDBC 很像——上层只面向接口编程,下层由具体驱动实现。正是这种抽象让 Zeos 能”一套代码对接 N 个数据库”。
2. 驱动层(dbc)
每个数据库对应一个子目录,例如 dbc/ZDBCMySql、dbc/ZDBCPostgreSql。驱动负责:
- 协议拼包与解析(如 MySQL 的握手包、PostgreSQL 的 startup message)
- 数据类型映射
- 特定 SQL 方言处理(如 LIMIT/OFFSET、分页语法差异)
3. 组件层(component)
对使用 VCL/LCL 的开发者来说,最常用的就是这一层。它把 ZDBC 的接口包装成标准的 TComponent 和 TDataSet 派生类,可以直接放到 DataModule 上,用可视化方式配置。
4. Plain 层
如果你的项目不需要 TDataSet(例如服务端程序、控制台程序),可以直接使用 plain 目录下的对象式 API,更轻量、更直接。
组件快速上手
安装
- 从 GitHub 克隆仓库。
- 进入
packages目录,按你的 Delphi 版本打开对应的包工程编译安装(例如Delphi12或lazarus)。 - 安装后会在组件面板上出现 Zeos 分类。
基本用法(以 Firebird 为例)
在窗体或 DataModule 上放置:
uses ZConnection, ZDataset; var ZConnection1: TZConnection; ZQuery1: TZQuery;
配置连接:
ZConnection1.Protocol := 'firebird-3.0'; ZConnection1.HostName := 'localhost'; ZConnection1.Port := 3050; ZConnection1.Database := 'c:\data\mydb.fdb'; ZConnection1.User := 'SYSDBA'; ZConnection1.Password := 'masterkey'; ZConnection1.Connect;
执行查询:
ZQuery1.Connection := ZConnection1;
ZQuery1.SQL.Text := 'SELECT ID, NAME FROM CUSTOMERS WHERE CITY = :CITY';
ZQuery1.ParamByName('CITY').AsString := 'Shanghai';
ZQuery1.Open;
while not ZQuery1.Eof do
begin
Memo1.Lines.Add(Format('%d - %s',
[ZQuery1.FieldByName('ID').AsInteger,
ZQuery1.FieldByName('NAME').AsString]));
ZQuery1.Next;
end;
ZQuery1.Close;
如果不想用组件,也可以纯代码方式:
uses
ZConnection, ZDataset;
var
Conn: TZConnection;
Qry: TZQuery;
begin
Conn := TZConnection.Create(nil);
try
Conn.Protocol := 'mysql';
Conn.HostName := '127.0.0.1';
Conn.Database := 'test';
Conn.User := 'root';
Conn.Password := '';
Conn.Connect;
Qry := TZQuery.Create(nil);
try
Qry.Connection := Conn;
Qry.SQL.Text := 'SELECT * FROM users';
Qry.Open;
// ...
finally
Qry.Free;
end;
finally
Conn.Free;
end;
end;
组件一览
| 组件 | 作用 |
|---|---|
TZConnection |
数据库连接,管理协议、主机、库名、字符集等 |
TZQuery |
执行 SQL 查询/更新,支持参数化 |
TZTable |
单表操作封装 |
TZStoredProc |
调用存储过程 |
TZUpdateSQL |
复杂查询的更新语句封装 |
支持数据库清单(摘要)
ZeosLib 官方支持并通过测试的数据库包括(协议名即 Protocol 属性值):
- MySQL / MariaDB:
mysql、mariadb - PostgreSQL:
postgresql - Firebird / Interbase:
firebird、interbase - SQLite:
sqlite-3 - Oracle:
oracle(需 OCI) - Microsoft SQL Server:
mssql(直连或 ODBC) - DB2:
db2 - Sybase ASE:
sybase - ODBC 通用:
odbc - SAP SQL Anywhere / ASA:
asa
具体协议字符串建议参考项目 src/dbc 目录下各驱动的文档或 ZPlainDriver 相关单元。
一些实战经验与注意事项
1. 字符集与 Unicode
新版本统一采用 UTF-8 传输。连接 MySQL 时务必设置:
ZConnection1.Properties.Values['characterEncoding'] := 'utf8';
或在协议端指定正确的 charset。否则中文乱码几乎是必然的。
2. 连接池
Zeos 提供了 TZConnection 的内建连接池支持:
ZConnection1.Properties.Values['Pooled'] := 'True'; ZConnection1.Properties.Values['MaxPooledConnections'] := '20';
对于多线程的 Web 后台或服务端程序,连接池几乎是必备的。注意配合 ZConnection1.GetConnection / ReleaseConnection 使用(线程内)。
3. 分页与方言差异
TZQuery 的 PageSize、FetchOptions 在不同数据库下表现不同。postgresql 与 mysql 都支持服务端游标式分页,但 Firebird 早期版本对 LIMIT 支持视版本而定。跨库项目里尽量用 Zeos 提供的分页机制,而非手写 SQL 方言。
4. 编译单元命名冲突
Zeos 的单元名(如 ZConnection、ZDataset)比较泛用。在大型项目中如果同时引入其他库,可能出现命名歧义,建议加包前缀或用别名:
uses ZConnection in '...\ZConnection.pas';
5. Free Pascal / Lazarus 下的使用
在 Lazarus 里通过 Online Package Manager 即可安装 Zeos,或者手动编译 packages/lazarus 下的包。跨平台(Linux/ARM)下 Firebird、PostgreSQL、SQLite 驱动均表现良好,是树莓派、国产化替代场景中 Pascal 程序的常见选择。
6. 版本兼容
Zeos 不同大版本(如 7.x 与 8.x)之间有一定 API 变化,尤其是在 Unicode 与事务接口上。升级前务必阅读仓库里的改动日志(Changelog.txt),并跑一遍回归。
与其他方案的对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| ZeosLib | 开源免费、跨库、跨编译器、纯 Pascal | 大结果集性能略逊于原生客户端 |
| FireDAC | 官方强支持、功能全、性能好 | 仅 Delphi、商业授权(高级版) |
| dbExpress | 官方、轻量 | 已停止更新、驱动依赖客户端库 |
| UniDAC | 性能优异、支持广 | 商业收费 |
如果预算有限、需要跨 Delphi + FPC、或者需要在 Linux/ARM 上跑数据服务,ZeosLib 基本是首选。
项目现状与社区
- 维护状态:GitHub 上持续有提交,主要维护者响应提交问题积极,issue 区能看到版本迭代讨论。
- 文档:官方 Wiki 与源码注释为主要参考;社区(如 Lazarus/Delphi 论坛、Stack Overflow)也有大量实例。
- 许可证:基于 MPL 1.1 与 LGPL 混合授权(以仓库说明为准),商业项目可放心使用。
结语
ZeosLib 的存在,对 Pascal 生态来说意义重大:它让”写 Pascal 程序连数据库”这件事不再受制于某个特定 IDE 或商业授权,也不需要在不同数据库之间写一大堆适配代码。它的设计思路——核心抽象 + 驱动实现 + 组件封装——虽然朴素,但非常务实。
如果你正维护一个老 Delphi 项目,想迁移到 PostgreSQL 或 SQLite;如果你在用 Lazarus 做跨平台的数据应用;如果你只是想找一个纯粹的、能读能写的数据库组件——ZeosLib 都值得放进工具箱。
项目地址:https://github.com/frones/ZeosLib
参与贡献:欢迎提交 issue 与 PR,也可以从阅读 src/core 与某个驱动源码开始理解它的运作方式。
(本文基于 ZeosLib 当前主干版本整理,具体 API 与属性以所用版本为准。)



还没有评论,来说两句吧...