Struct Builder

pub struct Builder<'client, 'builder, D: ?Sized + 'builder> { /* private fields */ }

Builds a Cursor

This type is constructed by calling Cursor::build.

Implementations

impl<'client, 'builder, D: Display + ?Sized + 'builder> Builder<'client, 'builder, D>

pub fn query_params( self, params: &'builder [&'builder (dyn ToSql + Sync)], ) -> Self

Set query params for cursor creation

pub fn batch_size(self, batch_size: u32) -> Self

Set the batch size passed to FETCH on each iteration.

Default is 5,000.

pub fn tag<D2: Display + ?Sized>( self, tag: &'builder D2, ) -> Builder<'client, 'builder, D2>

Set the tag for cursor name.

Adding a tag to the cursor name can be helpful for identifying where cursors originate when viewing pg_stat_activity.

Default is default.

Examples

Any type that implements fmt::Display may be provided as a tag. For example, a simple string literal is one option.

let mut cursor = Cursor::build(&mut client)
    .tag("custom-cursor-tag")
    .finalize();

Or maybe you want to build a tag at run-time without incurring an extra allocation:

use std::fmt;

struct Pid(i32);
impl fmt::Display for Pid {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "pid-{}", self.0)
    }
}

let tag = Pid(8123);
let mut cursor = Cursor::build(&mut client)
    .tag(&tag)
    .finalize();

pub fn query(self, query: &'builder str) -> Self

Set the query to create a cursor for.

Default is SELECT 1.

pub fn finalize(self) -> Result<Cursor<'client>, Error>

Turn the builder into a Cursor.