Struct fdb::transaction::FdbReadTransaction

pub struct FdbReadTransaction { /* private fields */ }

A handle to a FDB snapshot, suitable for performing snapshot reads.

Snapshot reads offer more relaxed isolation level than FDB’s default serializable isolation, reducing transaction conflicts but making it harder to reason about concurrency.

For more information about how to use snapshot reads correctly, see snapshot reads.

snapshot method on FdbTransaction can be used to create a FdbReadTransaction.

Implementations

impl FdbReadTransaction

pub async unsafe fn read<T, F, Fut>(&self, f: F) -> FdbResult<T>where F: FnMut(FdbReadTransaction) -> Fut, Fut: Future<Output = FdbResult<T>>,

Runs a closure in the context of this FdbReadTransaction.

Safety

You should not use this API. It exists to support binding tester.

Trait Implementations

impl Clone for FdbReadTransaction

fn clone(&self) -> FdbReadTransaction

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FdbReadTransaction

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

Formats the value using the given formatter.

impl ReadTransaction for FdbReadTransaction

unsafe fn on_error(&self, e: FdbError) -> FdbFutureUnit

Determines whether an error returned by a Transaction or ReadTransaction method is retryable. Waiting on the returned future will return the same error when fatal, or return () for retryable errors.

fn get(&self, key: impl Into<Key>) -> FdbFutureMaybeValue

Gets a value from the database.

fn get_addresses_for_key(&self, key: impl Into<Key>) -> FdbFutureCStringArray

Get a list of public network addresses as CString, one for each of the storage servers responsible for storing Key and its associated value.

fn get_estimated_range_size_bytes(&self, range: Range) -> FdbFutureI64

Gets an estimate for the number of bytes stored in the given range.

fn get_key(&self, selector: KeySelector) -> FdbFutureKey

Returns the key referenced by the specificed KeySelector.

fn get_mapped_range( &self, begin: KeySelector, end: KeySelector, mapper: impl Into<Mapper>, options: RangeOptions ) -> FdbStreamMappedKeyValue

WARNING: This feature is considered experimental at this time.

fn get_range( &self, begin: KeySelector, end: KeySelector, options: RangeOptions ) -> FdbStreamKeyValue

Gets an ordered range of keys and values from the database.

fn get_range_split_points( &self, begin: impl Into<Key>, end: impl Into<Key>, chunk_size: i64 ) -> FdbFutureKeyArray

Gets a list of keys that can split the given range into (roughly) equally sized chunks based on chunk_size.

unsafe fn get_read_version(&self) -> FdbFutureI64

Gets the version at which the reads for this Transaction or ReadTransaction will access the database.

unsafe fn set_option(&self, option: TransactionOption) -> FdbResult<()>

Set options on a Transaction or ReadTransaction

unsafe fn set_read_version(&self, version: i64)

Directly sets the version of the database at which to execute reads.