使用 sqlx 和/或 Tiberius 编写的异步 ORM

Welds

Welds 是使用 sqlx 和/或 Tiberius 编写的异步 ORM

功能

• 全面支持异步
• 支持多种 SQL 数据库 (Mssql, MySql, Postgres, Sqlite)
• 为了便于开发而编写。功能不需要在 traits 后面隐藏。代码应易于编写和阅读。
• 当您需要降级到原始 SQL 时，始终可用的低级别连接。

在底层，Welds 使用

• sqlx 用于 Postgres, MySql 和 Sqlite。
• Tiberius 用于 MSSQL

兼容性

• welds 的 0.4.* 线使用 sqlx 0.8 编译
• welds 的 0.3.* 线使用 sqlx 0.7 编译

示例设置

#[derive(Debug, WeldsModel)]
#[welds(schema= "inventory", table = "products")]
#[welds(BelongsTo(seller, super::people::People, "seller_id"))]
pub struct Product {
    #[welds(rename = "product_id")]
    #[welds(primary_key)]
    pub id: i32,
    pub name: String,
    pub seller_id: Option<i32>,
    pub description: Option<String>,
    pub price: Option<f32>,
}

示例用法

基本选择

  let url = "postgres://postgres:password@localhost:5432";
  let client = welds::connections::postgres::connect(url).await.unwrap();

  let products = Product::where_col(|p| p.price.equal(3.50)).run(&client).await?;

跨表的基本筛选

  let client = welds::connections::mssql::connect(url).await.unwrap();

  let sellers = Product::where_col(|product| product.price.equal(3.50))
        .map_query(|product| product.seller )
        .where_col(|seller| seller.name.ilike("%Nessie%") )
        .run(&client).await?;

创建和更新

  let client = welds::connections::sqlite::connect(url).await.unwrap();
  
  let mut cookies = Product::new();
  cookies.name = "cookies".to_owned();
  // Creates the product cookie
  cookies.save.await(&client)?; 
  cookies.description = "Yum".to_owned();
  // Updates the Cookies
  cookies.save.await(&client)?; 

其他示例

• 基本 CRUD
• 映射查询/连接
• 批量（创建/更新/删除）
• 选择特定的列
• 检查数据库模式与编译的结构体是否匹配

更多示例请查看 示例仓库。