Skip to main content

Crate dm_pure

Crate dm_pure 

Source
Expand description

§dm-pure:纯 Rust 达梦 DM8 数据库驱动

纯 Rust 实现的达梦 DM8 驱动,零数据库外部依赖。实现 DM 网络协议(握手 / 登录 / 执行 / 参数绑定 / LOB / 事务 / 分批 fetch)。

use dm_pure::{DmClient, Param};

let mut c = DmClient::new("127.0.0.1", 5236, "SYSDBA", "password");
c.connect()?;
// 查询(参数化)
let r = c.execute("SELECT id, name FROM t WHERE id >= ?", &[Param::Int(1)])?;
if let dm_pure::ExecuteResult::Query { columns, rows } = r {
    println!("cols: {:?}, first row: {:?}", columns, rows.first());
}
// 写入
c.execute("INSERT INTO t VALUES (?, ?)", &[Param::Int(1), Param::Str("x".into())])?;

更上层的 Cursor(DB-API 风格惰性游标)与连接池见 cursor / pool 模块。

Re-exports§

pub use client::ClientConfig;
pub use client::ExecuteResult;
pub use client::DmClient;
pub use client::OUT;
pub use client::OutType;
pub use client::Param;
pub use client::ServerParam;
pub use cursor::Cursor;
pub use pool::Connection;
pub use pool::ConnectionPool;
pub use pool::PooledConnection;
pub use result::Column;
pub use result::DmDate;
pub use result::DmDateTime;
pub use result::DmTime;
pub use result::Value;
pub use transaction::Transaction;

Modules§

client
达梦 DM8 最小客户端(参照 dm-pure Python 驱动移植)。
crypto
达梦登录加密(移植自 dm-pure Python 驱动 / dm-go-driver security 包)。
cursor
DB-API 风格惰性游标:fetchone / fetchmany / fetchall 按需拉取,大结果集自动分批。
frame
达梦 DM8 协议帧封装(64 字节定长头 + body)。
pool
连接池:复用连接避免重复握手(Web 服务场景必需)。
result
达梦结果集解析:列描述符 + 行数据 + 类型解码(对照 Go 驱动 + 抓包实测格式)。
transaction
事务 API:Transaction 借用 DmClient,Drop 时自动回滚(sqlx/dameng 风格)。

Structs§

DmError
达梦驱动错误。code 为服务器返回码(0 表示非协议错误),msg 为描述信息。

Functions§

dm_error_desc
常见达梦错误码描述表(与 Python 驱动一致)

Type Aliases§

Result
统一 Result 别名