Struct Cursor 

#[non_exhaustive]
pub struct Cursor<'a> { /* private fields */ }

A cursor for fetching a large result set in batches.

Created via Connection::query_cursor. Each call to Cursor::fetch_next returns the next batch of rows. The cursor is automatically closed when dropped, but explicit Cursor::close is recommended for clean shutdown.

Implementations

impl<'a> Cursor<'a>

pub async fn fetch_next(&mut self) -> Result<Vec<Row>>

Fetch the next batch of rows.

Returns an empty vector when all rows have been consumed.

pub async fn close(self) -> Result<()>

Close the cursor, releasing the portal on the server.

If the cursor automatically started a transaction (because no transaction was active when the cursor was created), the transaction is committed.

pub fn is_done(&self) -> bool

Returns true if all rows have been fetched.