nativeclick 0.26.9

Nativeclick is a pure Rust SDK for working with Clickhouse with the native protocol in async environments with minimal boilerplate and maximal performance.
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

use std::net::SocketAddr;
use tokio::net::ToSocketAddrs;

use crate::{Client, ClientOptions, NativeclickError, convert::UnitValue};

/// [`bb8`] connection manager for [`Client`]: plaintext TCP by default, TLS with
/// [`ConnectionManager::with_tls`].
#[derive(Clone)]
pub struct ConnectionManager {
    destination: Vec<SocketAddr>,
    options: ClientOptions,
    prequel: Option<String>,
    #[cfg(feature = "tls")]
    tls: Option<(
        rustls_pki_types::ServerName<'static>,
        tokio_rustls::TlsConnector,
    )>,
}

impl ConnectionManager {
    pub async fn new<A: ToSocketAddrs>(
        destination: A,
        options: ClientOptions,
    ) -> std::io::Result<Self> {
        Ok(Self {
            destination: tokio::net::lookup_host(destination).await?.collect(),
            options,
            prequel: None,
            #[cfg(feature = "tls")]
            tls: None,
        })
    }

    /// Connects over TLS (rustls), checking the server certificate against `name`.
    /// The connector carries the root certificates and the optional client certificate.
    #[cfg(feature = "tls")]
    pub fn with_tls(
        mut self,
        name: rustls_pki_types::ServerName<'static>,
        connector: tokio_rustls::TlsConnector,
    ) -> Self {
        self.tls = Some((name, connector));
        self
    }

    /// Runs `prequel` on every new connection, before handing it out.
    pub fn with_prequel(mut self, prequel: impl Into<String>) -> Self {
        self.prequel = Some(prequel.into());
        self
    }
}

impl bb8::ManageConnection for ConnectionManager {
    type Connection = Client;
    type Error = NativeclickError;

    async fn connect(&self) -> Result<Self::Connection, Self::Error> {
        #[cfg(feature = "tls")]
        let client = match &self.tls {
            Some((name, connector)) => {
                Client::connect_tls(
                    &self.destination[..],
                    self.options.clone(),
                    name.clone(),
                    connector,
                )
                .await?
            }
            None => Client::connect(&self.destination[..], self.options.clone()).await?,
        };
        #[cfg(not(feature = "tls"))]
        let client = Client::connect(&self.destination[..], self.options.clone()).await?;
        if let Some(prequel) = &self.prequel {
            client.execute(prequel).await?;
        }
        Ok(client)
    }

    async fn is_valid(&self, conn: &mut Self::Connection) -> Result<(), Self::Error> {
        let _ = conn.query_one::<UnitValue<String>>("select '';").await?;
        Ok(())
    }

    fn has_broken(&self, conn: &mut Self::Connection) -> bool {
        conn.is_closed()
    }
}