Trait diesel::query_builder::QueryFragment

pub trait QueryFragment<DB: Backend> {
    fn walk_ast(&self, pass: AstPass<DB>) -> QueryResult<()>;

    fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()> { ... }
    fn collect_binds(
        &self, 
        out: &mut DB::BindCollector, 
        metadata_lookup: &DB::MetadataLookup
    ) -> QueryResult<()> { ... }
    fn is_safe_to_cache_prepared(&self) -> QueryResult<bool> { ... }
}

An untyped fragment of SQL.

This may be a complete SQL command (such as an update statement without a RETURNING clause), or a subsection (such as our internal types used to represent a WHERE clause). Implementations of ExecuteDsl and LoadQuery will generally require that this trait be implemented.

Required methods

fn walk_ast(&self, pass: AstPass<DB>) -> QueryResult<()>

Walk over this QueryFragment for all passes.

This method is where the actual behavior of an AST node is implemented. This method will contain the behavior required for all possible AST passes. See AstPass for more details.

Loading content...

Provided methods

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

Converts this QueryFragment to its SQL representation.

This method should only be called by implementations of Connection.

fn collect_binds(
    &self,
    out: &mut DB::BindCollector,
    metadata_lookup: &DB::MetadataLookup
) -> QueryResult<()>

Serializes all bind parameters in this query.

A bind parameter is a value which is sent separately from the query itself. It is represented in SQL with a placeholder such as ? or $1.

This method should only be called by implementations of Connection.

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

Is this query safe to store in the prepared statement cache?

In order to keep our prepared statement cache at a reasonable size, we avoid caching any queries which represent a potentially unbounded number of SQL queries. Generally this will only return true for queries for which to_sql will always construct exactly identical SQL.

Some examples of where this method will return false are:

• SqlLiteral (We don't know if the SQL was constructed dynamically, so we must assume that it was)
• In and NotIn (Each value requires a separate bind param placeholder)

This method should only be called by implementations of Connection.

Loading content...

Trait Implementations

impl<DB> QueryId for dyn QueryFragment<DB>

type QueryId = ()

A type which uniquely represents Self in a SQL query.

const HAS_STATIC_QUERY_ID: bool

Can the SQL generated by Self be uniquely identified by its type?

fn query_id() -> Option<TypeId>

Returns the type id of Self::QueryId if Self::HAS_STATIC_QUERY_ID. Returns None otherwise.

Implementations on Foreign Types

impl<T: ?Sized, DB> QueryFragment<DB> for Box<T> where     DB: Backend,     T: QueryFragment<DB>,

fn walk_ast(&self, pass: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<'a, T: ?Sized, DB> QueryFragment<DB> for &'a T where     DB: Backend,     T: QueryFragment<DB>,

fn walk_ast(&self, pass: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<DB: Backend> QueryFragment<DB> for ()

fn walk_ast(&self, _: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<T, DB> QueryFragment<DB> for Option<T> where     DB: Backend,     T: QueryFragment<DB>,

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A,)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, J: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I, J)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, J: QueryFragment<__DB>, K: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I, J, K)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, J: QueryFragment<__DB>, K: QueryFragment<__DB>, L: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I, J, K, L)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, J: QueryFragment<__DB>, K: QueryFragment<__DB>, L: QueryFragment<__DB>, M: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I, J, K, L, M)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, J: QueryFragment<__DB>, K: QueryFragment<__DB>, L: QueryFragment<__DB>, M: QueryFragment<__DB>, N: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I, J, K, L, M, N)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, J: QueryFragment<__DB>, K: QueryFragment<__DB>, L: QueryFragment<__DB>, M: QueryFragment<__DB>, N: QueryFragment<__DB>, O: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I, J, K, L, M, N, O)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<A: QueryFragment<__DB>, B: QueryFragment<__DB>, C: QueryFragment<__DB>, D: QueryFragment<__DB>, E: QueryFragment<__DB>, F: QueryFragment<__DB>, G: QueryFragment<__DB>, H: QueryFragment<__DB>, I: QueryFragment<__DB>, J: QueryFragment<__DB>, K: QueryFragment<__DB>, L: QueryFragment<__DB>, M: QueryFragment<__DB>, N: QueryFragment<__DB>, O: QueryFragment<__DB>, P: QueryFragment<__DB>, __DB: Backend> QueryFragment<__DB> for (A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P)

fn walk_ast(&self, out: AstPass<__DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

Loading content...

Implementors

impl<'a> QueryFragment<Pg> for TransactionBuilder<'a>

fn walk_ast(&self, out: AstPass<Pg>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<DB> QueryFragment<DB> for SqlQuery where     DB: Backend,

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<DB: Backend> QueryFragment<DB> for now

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<Query, Value, DB> QueryFragment<DB> for UncheckedBind<Query, Value> where     DB: Backend,     Query: QueryFragment<DB>,     Value: QueryFragment<DB>,

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<ST, T, DB> QueryFragment<DB> for SqlLiteral<ST, T> where     DB: Backend,     T: QueryFragment<DB>,

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<T> QueryFragment<Pg> for DistinctOnClause<T> where     T: QueryFragment<Pg>,

fn walk_ast(&self, out: AstPass<Pg>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<T, U, Op, Ret, DB> QueryFragment<DB> for InsertStatement<T, U, Op, Ret> where     DB: Backend,     T: Table,     T::FromClause: QueryFragment<DB>,     U: QueryFragment<DB> + CanInsertInSingleQuery<DB>,     Op: QueryFragment<DB>,     Ret: QueryFragment<DB>,

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<T, U, Ret, DB> QueryFragment<DB> for DeleteStatement<T, U, Ret> where     DB: Backend,     T: Table,     T::FromClause: QueryFragment<DB>,     U: QueryFragment<DB>,     Ret: QueryFragment<DB>,

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<T, U, V, Ret, DB> QueryFragment<DB> for UpdateStatement<T, U, V, Ret> where     DB: Backend,     T: Table,     T::FromClause: QueryFragment<DB>,     U: QueryFragment<DB>,     V: QueryFragment<DB>,     Ret: QueryFragment<DB>,

fn walk_ast(&self, out: AstPass<DB>) -> QueryResult<()>

fn to_sql(&self, out: &mut DB::QueryBuilder) -> QueryResult<()>

fn collect_binds(     &self,     out: &mut DB::BindCollector,     metadata_lookup: &DB::MetadataLookup ) -> QueryResult<()>

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

Loading content...