Struct SelectQuery 

pub struct SelectQuery { /* private fields */ }

SELECT 查询构造器

Implementations

impl SelectQuery

pub fn new() -> Self

创建空的 SELECT 查询

pub fn distinct(self) -> Self

设置 DISTINCT

pub fn column(self, name: &str) -> Self

添加列

pub fn columns(self, names: &[&str]) -> Self

添加多个列

pub fn all_columns(self) -> Self

添加 * 列

pub fn from(self, table: &str) -> Self

设置 FROM 表

pub fn from_subquery(self, subquery_sql: &str, alias: &str) -> Self

设置 FROM 子查询：FROM (<subquery_sql>) AS <alias>

与 from 互斥，后调用者覆盖前者。 子查询 SQL 由调用方负责构造（可由另一个 SelectQuery::build 生成）， 别名经 dialect.quote() 转义，防止标识符逃逸。

示例

use sz_orm_core::DbType;
use sz_orm_query_builder::Query;

let inner = Query::select()
    .column("id")
    .column("amount")
    .from("orders")
    .build(DbType::MySQL);
let sql = Query::select()
    .column("id")
    .from_subquery(&inner, "t")
    .build(DbType::MySQL);
assert!(sql.contains("FROM (SELECT `id`, `amount` FROM `orders`) AS `t`"));

pub fn inner_join(self, table: &str, on: &str) -> Self

添加 INNER JOIN

安全性（门禁 9 修复）

表名经 quote_ident() 转义。on 条件为表达式，调用方应确保不使用恶意输入构造。

pub fn left_join(self, table: &str, on: &str) -> Self

添加 LEFT JOIN

安全性（门禁 9 修复）

同 inner_join，表名经 quote_ident() 转义。

pub fn right_join(self, table: &str, on: &str) -> Self

添加 RIGHT JOIN

安全性（门禁 9 修复）

同 inner_join，表名经 quote_ident() 转义。

pub fn inner_join_on(self, table: &str, left_col: &str, right_col: &str) -> Self

添加 INNER JOIN，ON 条件为列对列等值连接（left_col = right_col）

安全性

列名经 quote_column_dialect 按方言转义，防止标识符逃逸。 无参数值，纯标识符连接，最常见且最安全的 JOIN 形式。

pub fn left_join_on(self, table: &str, left_col: &str, right_col: &str) -> Self

添加 LEFT JOIN，ON 条件为列对列等值连接

pub fn right_join_on(self, table: &str, left_col: &str, right_col: &str) -> Self

添加 RIGHT JOIN，ON 条件为列对列等值连接

pub fn inner_join_param( self, table: &str, left_col: &str, op_expr: &str, value: Value, ) -> Self

添加 INNER JOIN，ON 条件为参数化表达式（left_col op ?）

参数

• table: JOIN 的表名（支持别名 orders o）
• left_col: 左侧列名（已转义）
• op_expr: 运算符 + 占位符部分（如 = ?、 > ?、 IN (?, ?)）
• value: 单个参数值

pub fn left_join_param( self, table: &str, left_col: &str, op_expr: &str, value: Value, ) -> Self

添加 LEFT JOIN，ON 条件为参数化表达式

pub fn right_join_param( self, table: &str, left_col: &str, op_expr: &str, value: Value, ) -> Self

添加 RIGHT JOIN，ON 条件为参数化表达式

pub fn where_clause(self, condition: &str) -> Self

添加 WHERE 条件（AND 连接）

安全性（v0.2.2 修复 C-6）

调用 check_where_injection 检测高危模式（分号+SQL 关键字、行注释、块注释）。 复杂 WHERE 条件应使用参数化查询 API，避免直接拼接字符串。

pub fn or_where(self, condition: &str) -> Self

添加 OR WHERE 条件

安全性（v0.2.2 修复 C-6）

同 where_clause，调用 check_where_injection 检测高危模式。

pub fn where_eq(self, column: &str, value: Value) -> Self

添加 column = ? AND 条件

pub fn where_ne(self, column: &str, value: Value) -> Self

添加 column <> ? AND 条件

pub fn where_gt(self, column: &str, value: Value) -> Self

添加 column > ? AND 条件

pub fn where_ge(self, column: &str, value: Value) -> Self

添加 column >= ? AND 条件

pub fn where_lt(self, column: &str, value: Value) -> Self

添加 column < ? AND 条件

pub fn where_le(self, column: &str, value: Value) -> Self

添加 column <= ? AND 条件

pub fn where_like(self, column: &str, pattern: Value) -> Self

添加 column LIKE ? AND 条件

pub fn where_in(self, column: &str, values: Vec<Value>) -> Self

添加 column IN (?, ?, ...) AND 条件

空列表生成 1 = 0（恒假），避免生成非法的 IN ()。

pub fn where_not_in(self, column: &str, values: Vec<Value>) -> Self

添加 column NOT IN (?, ?, ...) AND 条件

空列表生成 1 = 1（恒真），避免生成非法的 NOT IN ()。

pub fn where_between(self, column: &str, low: Value, high: Value) -> Self

添加 column BETWEEN ? AND ? AND 条件

pub fn where_null(self, column: &str) -> Self

添加 column IS NULL AND 条件

pub fn where_not_null(self, column: &str) -> Self

添加 column IS NOT NULL AND 条件

pub fn or_where_eq(self, column: &str, value: Value) -> Self

添加 column = ? OR 条件

pub fn or_where_ne(self, column: &str, value: Value) -> Self

添加 column <> ? OR 条件

pub fn or_where_gt(self, column: &str, value: Value) -> Self

添加 column > ? OR 条件

pub fn or_where_ge(self, column: &str, value: Value) -> Self

添加 column >= ? OR 条件

pub fn or_where_lt(self, column: &str, value: Value) -> Self

添加 column < ? OR 条件

pub fn or_where_le(self, column: &str, value: Value) -> Self

添加 column <= ? OR 条件

pub fn or_where_like(self, column: &str, pattern: Value) -> Self

添加 column LIKE ? OR 条件

pub fn or_where_in(self, column: &str, values: Vec<Value>) -> Self

添加 column IN (?, ?, ...) OR 条件

pub fn or_where_between(self, column: &str, low: Value, high: Value) -> Self

添加 column BETWEEN ? AND ? OR 条件

pub fn or_where_null(self, column: &str) -> Self

添加 column IS NULL OR 条件

pub fn or_where_not_null(self, column: &str) -> Self

添加 column IS NOT NULL OR 条件

pub fn group_by(self, column: &str) -> Self

添加 GROUP BY

pub fn having(self, condition: &str) -> Self

添加 HAVING

pub fn order_by(self, column: &str, asc: bool) -> Self

添加 ORDER BY

参数

• column: 列名
• asc: true=ASC, false=DESC

pub fn limit(self, n: u64) -> Self

设置 LIMIT

pub fn offset(self, n: u64) -> Self

设置 OFFSET

pub fn paginate(self, page: u64, size: u64) -> Self

生成分页（同时设置 LIMIT 和 OFFSET）

参数

• page: 页码（从 1 开始）
• size: 每页大小

pub fn with_cte(self, name: &str, subquery: &str) -> Self

添加 CTE（Common Table Expression / WITH 子句）。

生成形如 WITH name AS (subquery) SELECT ... 的 SQL。

参数

• name: CTE 名称
• subquery: 子查询 SQL（完整的 SELECT 语句）

pub fn with_recursive_cte(self, name: &str, subquery: &str) -> Self

添加递归 CTE（WITH RECURSIVE name AS (...) SELECT ...）。

参数

• name: CTE 名称
• subquery: 递归子查询 SQL

pub fn window_function(self, expr: &str) -> Self

添加窗口函数列（作为 SELECT 列表的原始表达式）。

调用方负责构造完整的窗口函数表达式，例如：

• ROW_NUMBER() OVER (PARTITION BY dept ORDER BY salary DESC)
• RANK() OVER (ORDER BY score DESC)
• SUM(amount) OVER (PARTITION BY user_id ORDER BY created_at)

参数

• expr: 完整的窗口函数表达式

pub fn row_number(self, partition_by: &str, order_by: &str, alias: &str) -> Self

添加 ROW_NUMBER() 窗口函数列。

参数

• partition_by: PARTITION BY 列（可为空）
• order_by: ORDER BY 列（如 salary DESC）
• alias: 结果列别名（如 row_num）

pub fn rank(self, partition_by: &str, order_by: &str, alias: &str) -> Self

添加 RANK() 窗口函数列。

参数

• partition_by: PARTITION BY 列（可为空）
• order_by: ORDER BY 列
• alias: 结果列别名

pub fn dense_rank(self, partition_by: &str, order_by: &str, alias: &str) -> Self

添加 DENSE_RANK() 窗口函数列。

参数

• partition_by: PARTITION BY 列（可为空）
• order_by: ORDER BY 列
• alias: 结果列别名

pub fn for_update(self) -> Self

设置 FOR UPDATE 行锁。

在生成的 SQL 末尾追加 FOR UPDATE，用于悲观锁。

pub fn for_update_with_options(self, options: &str) -> Self

设置 FOR UPDATE 并附带选项（如 NOWAIT、SKIP LOCKED）。

参数

• options: 选项字符串，如 "NOWAIT" 或 "SKIP LOCKED"

pub fn union(self, other: SelectQuery) -> SetQuery

将当前查询与另一个查询进行 UNION 集合运算。

返回一个 SetQuery，可通过 build() 生成最终 SQL。

pub fn union_all(self, other: SelectQuery) -> SetQuery

将当前查询与另一个查询进行 UNION ALL 集合运算。

pub fn intersect(self, other: SelectQuery) -> SetQuery

将当前查询与另一个查询进行 INTERSECT 集合运算。

pub fn except(self, other: SelectQuery) -> SetQuery

将当前查询与另一个查询进行 EXCEPT 集合运算。

pub fn build(self, db_type: DbType) -> String

生成 SQL

参数

• db_type: 数据库类型，用于选择方言

pub fn build_with_params(self, db_type: DbType) -> BuiltQuery

生成带参数的 SQL（参数化查询，P0 修复：SQL 注入防护）

返回 BuiltQuery，包含带 ? 占位符的 SQL 与按序绑定的参数列表。 与 build 的区别：

• WHERE 条件可来自 where_eq/where_in/where_between 等参数化 API
• 用户输入作为参数绑定，而非字符串拼接到 SQL 中

混合使用规则

当同时使用原始 where_clause(&str) 与参数化 where_eq(column, value) 时：

• 原始条件先渲染（无参数）
• 参数化条件后渲染（按顺序收集参数）
• 两者均按调用顺序保持 AND/OR 连接语义

示例

use sz_orm_core::{DbType, Value};
use sz_orm_query_builder::Query;

let built = Query::select()
    .column("id")
    .from("users")
    .where_eq("age", Value::I32(18))
    .or_where_eq("role", Value::String("admin".into()))
    .build_with_params(DbType::MySQL);
assert!(built.sql.contains("WHERE `age` = ? OR `role` = ?"));
assert_eq!(built.params.len(), 2);

Trait Implementations

impl Clone for SelectQuery

fn clone(&self) -> SelectQuery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SelectQuery

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

Formats the value using the given formatter.

impl Default for SelectQuery

fn default() -> SelectQuery

Returns the “default value” for a type.