Struct Query 

pub struct Query { /* private fields */ }

类型化裸 SQL 查询构建器。

由 query_as! 宏生成，等效于 SQLx 的 query_as!(Record, "SELECT ...")： 在编译期验证 SQL 语法（db-verify feature 下连真 DB 验证列名）， 运行时将结果行按列名映射到 T: FromQueryResult。

用法

use sz_orm_core::queryable::QueryAs;

#[derive(FromQueryResult)]
struct User { id: i64, name: String }

let q = QueryAs::<User>::new("SELECT id, name FROM users WHERE id = ?");
let users: Vec<User> = q.fetch_all(&mut conn).await?;
let one: User = QueryAs::<User>::new("SELECT id, name FROM users LIMIT 1")
    .fetch_one(&mut conn)
    .await?;

无类型裸 SQL 查询对象（SQLx query! 的 sz-orm 等效物）。

与 QueryAs<T> 的区别：Query 返回 Vec<HashMap<String, Value>>， 不绑定具体结构体类型；QueryAs<T> 将行映射为 T: FromQueryResult。

用法

use sz_orm_core::queryable::Query;

let q = Query::new("SELECT id, name FROM users WHERE id = ?");
let rows = q.fetch_all(&mut conn).await?;

Implementations

impl Query

pub fn new(sql: impl Into<String>) -> Self

从 SQL 字符串构造查询对象

pub fn sql(&self) -> &str

获取底层 SQL（用于日志/调试）

impl Query

pub async fn fetch_all( &self, conn: &mut dyn Connection, ) -> Result<Vec<HashMap<String, Value>>, DbError>

执行查询，返回所有行（Vec<HashMap<列名, Value>>）

pub async fn fetch_one( &self, conn: &mut dyn Connection, ) -> Result<HashMap<String, Value>, DbError>

执行查询，期望恰好一行；0 行或多行均返回错误

pub async fn fetch_optional( &self, conn: &mut dyn Connection, ) -> Result<Option<HashMap<String, Value>>, DbError>

执行查询，返回 0 或 1 行；0 行返回 Ok(None)

Trait Implementations

impl Display for Query

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.