Trait pgx::spi::Query

pub trait Query {
    type Arguments;
    type Result;

    // Required methods
    fn execute(
        self,
        client: &SpiClient<'_>,
        limit: Option<c_long>,
        arguments: Self::Arguments
    ) -> Self::Result;
    fn open_cursor<'c: 'cc, 'cc>(
        self,
        client: &'cc SpiClient<'c>,
        args: Self::Arguments
    ) -> SpiCursor<'c>;
}

A generalized interface to what constitutes a query

Its primary purpose is to abstract away differences between one-off statements and prepared statements, but it can potentially be implemented for other types, provided they can be converted into a query.

Required Associated Types

type Arguments

type Result

Required Methods

fn execute( self, client: &SpiClient<'_>, limit: Option<c_long>, arguments: Self::Arguments ) -> Self::Result

Execute a query given a client and other arguments

fn open_cursor<'c: 'cc, 'cc>( self, client: &'cc SpiClient<'c>, args: Self::Arguments ) -> SpiCursor<'c>

Open a cursor for the query

Implementations on Foreign Types

impl<'a> Query for &'a str

fn execute( self, _client: &SpiClient<'_>, limit: Option<c_long>, arguments: Self::Arguments ) -> Self::Result

Panics

This function will panic if somehow the specified query contains a null byte.

type Arguments = Option<Vec<(PgOid, Option<Datum>), Global>>

type Result = Result<SpiTupleTable, Error>

fn open_cursor<'c: 'cc, 'cc>( self, _client: &'cc SpiClient<'c>, args: Self::Arguments ) -> SpiCursor<'c>

impl<'a> Query for &'a String

type Arguments = Option<Vec<(PgOid, Option<Datum>), Global>>

type Result = Result<SpiTupleTable, Error>

fn execute( self, client: &SpiClient<'_>, limit: Option<c_long>, arguments: Self::Arguments ) -> Self::Result

fn open_cursor<'c: 'cc, 'cc>( self, client: &'cc SpiClient<'c>, args: Self::Arguments ) -> SpiCursor<'c>

Implementors

impl Query for OwnedPreparedStatement

type Arguments = Option<Vec<Option<Datum>, Global>>

type Result = Result<SpiTupleTable, Error>

impl<'a> Query for &'a OwnedPreparedStatement

type Arguments = Option<Vec<Option<Datum>, Global>>

type Result = Result<SpiTupleTable, Error>

impl<'a> Query for PreparedStatement<'a>

type Arguments = Option<Vec<Option<Datum>, Global>>

type Result = Result<SpiTupleTable, Error>

impl<'a: 'b, 'b> Query for &'b PreparedStatement<'a>

type Arguments = Option<Vec<Option<Datum>, Global>>

type Result = Result<SpiTupleTable, Error>