Struct AsyncPreparedStatementOwned 

pub struct AsyncPreparedStatementOwned { /* private fields */ }

Owned-handle variant of AsyncPreparedStatement that holds an Arc<AsyncConnection> instead of a borrow.

Semantics are identical to AsyncPreparedStatement. The only difference is that this variant is 'static and can therefore live in structs that can’t carry lifetimes — N-API classes, tokio::spawn tasks that outlive the constructor, etc.

Implementations

impl AsyncPreparedStatementOwned

pub fn param_count(&self) -> usize

Number of parameters the statement expects.

pub fn param_types(&self) -> &[Oid]

Parameter type OIDs.

pub fn schema(&self) -> &ResultSchema

Result-column schema, captured at prepare time.

pub fn sql(&self) -> &str

Original SQL text.

pub async fn fetch_all(&self, params: &[&dyn ToSqlParam]) -> Result<Vec<Row>>

Executes the statement and returns a materialized Vec<Row>.

Unlike AsyncPreparedStatement::query, the owned variant returns an owned Vec<Row> rather than a streaming AsyncRowset: AsyncRowset is itself lifetime-bound to the connection’s mutex guard, which defeats the purpose of the owned wrapper. N-API callers that want streaming should fall back to the non-owned AsyncPreparedStatement via AsyncConnection::prepare or use the non-streaming query methods below.

Errors

• Returns Error::Other on gRPC transport.
• Returns Error::Client if the server rejects Bind or Execute, or raises a runtime error while streaming.
• Returns Error::Io on transport-level I/O failures.

pub async fn execute(&self, params: &[&dyn ToSqlParam]) -> Result<u64>

Executes the statement as a command; returns the affected-row count.

Errors

• Returns Error::Other on gRPC transport.
• Returns Error::Client if the server rejects Bind or Execute.
• Returns Error::Io on transport-level I/O failures.

pub async fn fetch_one(&self, params: &[&dyn ToSqlParam]) -> Result<Row>

Fetches exactly one row; errors on empty.

Errors

• Returns the error from fetch_all.
• Returns Error::Other with message "Query returned no rows" if the result is empty.

pub async fn fetch_optional( &self, params: &[&dyn ToSqlParam], ) -> Result<Option<Row>>

Fetches at most one row; None on empty.

Errors

Returns the error from fetch_all; an empty result yields Ok(None).

pub async fn fetch_scalar<T: RowValue>( &self, params: &[&dyn ToSqlParam], ) -> Result<T>

Fetches the first column of the first row as T.

Errors

• Returns the error from fetch_one.
• Returns Error::Other with message "Scalar query returned NULL" if the first cell is SQL NULL.

pub async fn fetch_optional_scalar<T: RowValue>( &self, params: &[&dyn ToSqlParam], ) -> Result<Option<T>>

Fetches the first column of the first row as Option<T>.

Errors

Returns the error from fetch_optional; SQL NULL yields Ok(None).

pub fn close(self)

Explicitly close the statement on the server.

Equivalent to dropping the struct — the inner hyperdb_api_core::client::AsyncPreparedStatement has its own Drop-time best-effort close.

Trait Implementations

impl Debug for AsyncPreparedStatementOwned

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

Formats the value using the given formatter.