ydb 0.17.1

Crate contains generated low-level grpc code from YDB API protobuf, used as base for ydb crate
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use std::future::Future;
use std::sync::Arc;
use std::time::{Duration, Instant};

use crate::client::TimeoutSettings;
use crate::errors::{NeedRetry, YdbResult};
use crate::retry::{IndefiniteRetrier, Retry, RetryParams, TimeoutRetrier};
use crate::retry_budget::{RetryControl, RetryPauseError, acquire_retry_budget};

use tracing::instrument;

#[derive(Clone, Debug, Default)]
pub(crate) struct TableCallOptions {
    pub timeout: Option<Duration>,
    pub idempotent: Option<bool>,
}

pub(crate) fn resolve_idempotent(opts: &TableCallOptions, default: bool) -> bool {
    opts.idempotent.unwrap_or(default)
}

pub(crate) fn resolve_timeouts(opts: &TableCallOptions) -> TimeoutSettings {
    TimeoutSettings {
        operation_timeout: opts.timeout,
    }
}

#[instrument(name = "ydb.TableClient.RetryOperation", skip_all, fields(db.system.name = "ydb"), err)]
pub(crate) async fn retry_table_operation<CallbackFuture, CallbackResult>(
    retry_control: &RetryControl,
    opts: &TableCallOptions,
    idempotent: bool,
    callback: impl Fn() -> CallbackFuture,
) -> YdbResult<CallbackResult>
where
    CallbackFuture: Future<Output = YdbResult<CallbackResult>>,
{
    let retrier: Arc<dyn Retry> = match opts.timeout {
        None => Arc::new(IndefiniteRetrier {}),
        Some(timeout) => Arc::new(TimeoutRetrier { timeout }),
    };
    let mut attempt: usize = 0;
    let start = Instant::now();
    loop {
        retry_control.metrics().record_attempt();
        attempt += 1;
        let last_err = match callback().await {
            Ok(res) => return Ok(res),
            Err(err) => match (err.need_retry(), idempotent) {
                (NeedRetry::True, _) => err,
                (NeedRetry::IdempotentOnly, true) => err,
                _ => return Err(err),
            },
        };

        let now = Instant::now();
        let retry_decision = retrier.retry_decision(RetryParams {
            attempt,
            time_from_start: now.duration_since(start),
        });
        if !retry_decision.allow_retry {
            return Err(last_err);
        }
        tokio::time::sleep(retry_decision.wait_timeout).await;
        match acquire_retry_budget(retry_control, start, opts.timeout).await {
            Ok(()) => {}
            Err(RetryPauseError::Timeout) | Err(RetryPauseError::Budget(_)) => {
                return Err(last_err);
            }
        }
    }
}