Struct Query

pub struct Query(/* private fields */);

A SQL query.

Implementations

impl Query

pub fn new(sql: String) -> Self

pub fn sql(&self) -> &str

pub fn append(&mut self, other: Self) -> TernResult<()>

Add another query to the end of this one.

pub fn split_statements(&self) -> TernResult<Vec<String>>

Split a query comprised of multiple statements.

For queries having no_tx = true, a migration comprised of multiple, separate SQL statements needs to be broken up so that the statements can run sequentially. Otherwise, many backends will run the collection of statements in a transaction automatically, which breaches the no_tx contract.

Warning: This is sensitive to the particular character sequence for writing comments. Only -- and C-style /* ... */ are treated correctly because this is valid comment syntax in any of the supported backends. A line starting with #, for instance, will not be treated as a comment, and so only in MySQL where that does denote a comment, the function may not separate multiple statements correctly, possibly leading to syntax errors during query execution.

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 Display for Query

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

Formats the value using the given formatter.