Struct Statement 

pub struct Statement { /* private fields */ }

A query with optional execution limits. Use Self::execute to wait for its result, or Self::submit to retain a handle for progress and cancellation.

Implementations

impl Statement

pub fn with_statement_id(self, statement_id: Uuid) -> Self

pub fn with_max_elapsed(self, duration: Duration) -> Self

Limits total elapsed time on the server, including queueing.

pub fn with_max_estimated(self, duration: Duration) -> Self

Rejects execution when its estimated duration exceeds this limit.

pub async fn submit(self) -> Result<StatementHandle, Error>

Submits one statement. An interrupted response does not establish whether execution started. Supply an ID with Self::with_statement_id to look it up after such a failure without submitting another execution.

Examples found in repository

examples/statement.rs (line 27)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = common::client()?;

    let result = client.query("SELECT 1 AS ready").await?;
    let rows = result.into_objects()?;
    println!("rows: {rows:?}");

    // Keep the handle when an application needs progress, cancellation, or a
    // durable statement ID before waiting for the result.
    let mut handle = client.statement("SELECT 2 AS value").submit().await?;
    let statement_id = handle.statement_id();
    println!(
        "statement {statement_id} submitted: {:?}",
        handle.snapshot()
    );
    let status = handle.refresh().await?;
    println!("statement {statement_id}: {status:?}");
    let result = handle.wait().await?;
    println!("handle rows: {:?}", result.into_objects()?);
    Ok(())
}

pub async fn execute(self) -> Result<ResultSet, Error>

Submits and waits. Dropping this future stops polling, not server execution. Retain a submitted handle to request cancellation explicitly. Errors after submission retain Error::statement_id and never indicate that resubmitting is safe. Resume with Client::statement_handle instead.

Trait Implementations

impl Debug for Statement

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

Formats the value using the given formatter.