tiberius_row 0.1.1

一个简化从Tiberius SQL Server客户端行数据到Rust结构体转换的过程宏库
Documentation

Tiberius Row

tiberius_row 是一个Rust过程宏库，用于简化从Tiberius SQL Server客户端获取的行数据到Rust结构体的转换过程。

功能特点

  • 提供Row_Ext派生宏，自动为结构体实现从Tiberius行数据到Rust结构体的转换
  • 支持多种SQL数据类型，包括整数、浮点数、字符串、日期时间等
  • 使用serde进行数据反序列化，提供类型安全的数据访问
  • 自动处理NULL值
  • 提供友好的错误处理

安装

在你的Cargo.toml文件中添加以下依赖：

[dependencies]

tiberius_row = "0.1.0"

tiberius = { version = "0.12.3", features = ["chrono"] }

serde = { version = "1.0", features = ["derive"] }

anyhow = "1.0"

chrono = "0.4.40"

serde_yaml = "0.9.34"

使用方法

  1. 首先，为你的结构体派生必要的特性：
use serde::Deserialize;
use tiberius_row::Row_Ext;

#[derive(Deserialize, Row_Ext)]
struct User {
    id: i32,
    name: String,
    email: Option<String>,
    created_at: chrono::DateTime<chrono::Utc>,
}
  1. 然后，你可以直接从Tiberius的Row转换为你的结构体：
use anyhow::Result;
use tiberius::Client;

async fn get_user(client: &mut Client<Connection>, user_id: i32) -> Result<User> {
    let query = "SELECT id, name, email, created_at FROM users WHERE id = @P1";
    let stream = client.query(query, &[&user_id]).await?;
    let row = stream.into_row().await?.expect("No user found");
    
    // 使用派生的from_row方法
    let user = User::from_row(row)?;
    Ok(user)
}

支持的数据类型

  • 整数类型：i16, i32, i64, u8
  • 浮点类型：f32, f64
  • 字符串：String
  • 布尔值：bool（通过Bit类型）
  • 日期时间：chrono::DateTime<chrono::Utc>
  • 数值类型：Numeric

错误处理

该库使用anyhow进行错误处理，当遇到不支持的列数据类型或反序列化失败时会返回适当的错误。

许可证

MIT

贡献

欢迎提交问题和拉取请求！