Struct MutationId 

pub struct MutationId { /* private fields */ }

A GUID the cluster deduplicates a repeated mutation by.

The client generates one for every mutating command it may have to repeat, so retries never apply a change twice. Passing your own is for a stronger guarantee than one process can give itself: persist the ID, and replaying the command after a crash returns the original result rather than starting a second operation. See Client::start_operation_with.

A replay must say that it is one. The ID carries that flag, because the cluster does not infer it: sending a known ID again without it is refused with Duplicate request is not marked as "retry" rather than deduplicated.

use ytsaurus_client::MutationId;

let first = MutationId::new();       // the original request
let again = first.as_retry();        // the same mutation, sent again

assert_eq!(first.as_str(), again.as_str());
assert!(!first.is_retry() && again.is_retry());

Implementations

impl MutationId

pub fn new() -> Self

A fresh ID, for an original request.

pub fn as_retry(&self) -> Self

The same ID, marked as a replay of a request already sent.

This is what makes the cluster return the first response instead of refusing the duplicate.

pub fn as_str(&self) -> &str

The ID, as YTsaurus spells a GUID.

pub fn is_retry(&self) -> bool

Whether this send is a replay.

Trait Implementations

impl Clone for MutationId

fn clone(&self) -> MutationId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MutationId

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

Formats the value using the given formatter.

impl Default for MutationId

fn default() -> Self

Returns the “default value” for a type.

impl Display for MutationId

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

Formats the value using the given formatter.

impl Eq for MutationId

impl PartialEq for MutationId

fn eq(&self, other: &MutationId) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MutationId