Struct Query 

pub struct Query {
    pub with: Option<With>,
    pub body: ExprSet,
    pub single: bool,
    pub order_by: Option<OrderBy>,
    pub limit: Option<Limit>,
    pub locks: Vec<Lock>,
}

Fields

with: Option<With>

Any CTEs

body: ExprSet

The body of the query. Either SELECT, UNION, VALUES, or possibly other types of queries depending on database support.

single: bool

When true, the Query returns a single record vs. a list. Note, that this is different from LIMIT 1 as there should only ever be 1 possible result. Also, the return type becomes Record instead of List.

order_by: Option<OrderBy>

ORDER BY

limit: Option<Limit>

LIMIT and OFFSET (count or keyset)

locks: Vec<Lock>

FOR { UPDATE | SHARE }

Implementations

impl Query

pub fn filter(&self) -> Option<&Filter>

pub fn filter_unwrap(&self) -> &Filter

pub fn filter_mut(&mut self) -> Option<&mut Filter>

Returns a mutable reference to the query’s filter.

Returns None for queries that are not SELECT statements, such as UNION or VALUES.

pub fn filter_mut_unwrap(&mut self) -> &mut Filter

Returns a mutable reference to the query’s filter.

Panics

Panics if the query body is not a SELECT statement.

impl Query

pub fn new(body: impl Into<ExprSet>) -> Self

pub fn new_single(body: impl Into<ExprSet>) -> Self

pub fn new_select(source: impl Into<Source>, filter: impl Into<Filter>) -> Self

pub fn builder(body: impl Into<ExprSet>) -> QueryBuilder

pub fn unit() -> Self

pub fn values(values: impl Into<Values>) -> Self

pub fn update(self) -> Update

pub fn delete(self) -> Delete

pub fn add_filter(&mut self, filter: impl Into<Filter>)

pub fn add_union(&mut self, other: impl Into<Self>)

pub fn include(&mut self, path: impl Into<Path>)

impl Query

pub fn returning(&self) -> Option<&Returning>

Returns a reference to this query’s RETURNING clause, if present.

Returns Some only for SELECT queries. Other query types (VALUES, UNION, etc.) do not have a RETURNING clause.

pub fn returning_unwrap(&self) -> &Returning

Returns a reference to this query’s RETURNING clause.

Panics

Panics if the query does not have a RETURNING clause (i.e., the body is not a SELECT).

pub fn returning_mut(&mut self) -> Option<&mut Returning>

Returns a mutable reference to this query’s RETURNING clause, if present.

Returns Some only for SELECT queries. Other query types (VALUES, UNION, etc.) do not have a RETURNING clause.

pub fn returning_mut_unwrap(&mut self) -> &mut Returning

Returns a mutable reference to this query’s RETURNING clause.

Panics

Panics if the query does not have a RETURNING clause (i.e., the body is not a SELECT).

impl Query

pub fn into_select(self) -> Select

Trait Implementations

impl Clone for Query

fn clone(&self) -> Query

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Query

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

Formats the value using the given formatter.

impl From<Query> for InsertTarget

fn from(value: Query) -> Self

Converts to this type from the input type.

impl From<Query> for Statement

fn from(value: Query) -> Self

Converts to this type from the input type.

impl From<Select> for Query

fn from(value: Select) -> Self

Converts to this type from the input type.

impl From<Values> for Query

fn from(value: Values) -> Self

Converts to this type from the input type.

impl<'a, T: Resolve> IntoExprTarget<'a, T> for &'a Query

fn into_expr_target(self, schema: &'a T) -> ExprTarget<'a>

impl Node for Query

fn visit<V: Visit>(&self, visit: V)

fn visit_mut<V: VisitMut>(&mut self, visit: V)

impl PartialEq for Query

fn eq(&self, other: &Query) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Query