Struct Statement 

#[non_exhaustive]
pub struct Statement {
    pub sql: String,
    pub args: Vec<Value>,
    pub query_type: QueryType,
}

What crosses the executor boundary: exactly what build() produces, plus the statement-kind hint core already carries.

Owned, so an executor’s future borrows nothing from the caller’s query. Constructing one by hand — Statement::new — is the raw-SQL escape hatch, mirroring core’s “the build() seam is always open”: the SQL is passed to the driver verbatim, in the backend’s own placeholder syntax, with the arguments bound per docs/type-mappings.md.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

sql: String

The SQL text, placeholders included.

args: Vec<Value>

The arguments, one per placeholder.

query_type: QueryType

Which statement this is. Feeds tracing; never policed against the SQL.

Implementations

impl Statement

pub fn new(sql: impl Into<String>, args: Vec<Value>) -> Self

A raw statement. sql is sent to the driver verbatim.

pub fn from_query(q: &(impl Query + ?Sized)) -> Result<Self, ExecError>

Build a query into a statement. This is the only path the Execute verbs use.

Trait Implementations

impl Clone for Statement

fn clone(&self) -> Statement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Statement

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

Formats the value using the given formatter.

impl PartialEq for Statement

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Statement