chore: add compression encoding for request/response

Author: paomian

examples/ingest.rs

@@ -18,7 +18,7 @@ use greptimedb_ingester::api::v1::*;
 use greptimedb_ingester::helpers::schema::*;
 use greptimedb_ingester::helpers::values::*;
 use greptimedb_ingester::{
-    ChannelConfig, ChannelManager, Client, ClientTlsOption, Database, DEFAULT_SCHEMA_NAME,
+    ChannelConfig, ChannelManager, ClientBuilder, ClientTlsOption, Database, DEFAULT_SCHEMA_NAME,
 };
 
 #[tokio::main]
@@ -36,9 +36,14 @@ async fn main() {
 
         let channel_manager = ChannelManager::with_tls_config(channel_config)
             .expect("Failed to create channel manager");
-        Client::with_manager_and_urls(channel_manager, vec![&greptimedb_endpoint])
+        ClientBuilder::default()
+            .channel_manager(channel_manager)
+            .peers(vec![&greptimedb_endpoint])
+            .build()
     } else {
-        Client::with_urls(vec![&greptimedb_endpoint])
+        ClientBuilder::default()
+            .peers(vec![&greptimedb_endpoint])
+            .build()
     };
 
     let client = Database::new_with_dbname(greptimedb_dbname, grpc_client);

examples/stream_ingest.rs

@@ -15,7 +15,7 @@
 use derive_new::new;
 
 use greptimedb_ingester::api::v1::*;
-use greptimedb_ingester::{Client, Database, DEFAULT_SCHEMA_NAME};
+use greptimedb_ingester::{ClientBuilder, Database, DEFAULT_SCHEMA_NAME};
 
 #[tokio::main]
 async fn main() {
@@ -25,7 +25,9 @@ async fn main() {
     let greptimedb_dbname =
         std::env::var("GREPTIMEDB_DBNAME").unwrap_or_else(|_| DEFAULT_SCHEMA_NAME.to_owned());
 
-    let grpc_client = Client::with_urls(vec![&greptimedb_endpoint]);
+    let grpc_client = ClientBuilder::default()
+        .peers(vec![&greptimedb_endpoint])
+        .build();
 
     let client = Database::new_with_dbname(greptimedb_dbname, grpc_client);
 

src/client.rs

@@ -20,6 +20,7 @@ use crate::api::v1::HealthCheckRequest;
 use crate::channel_manager::ChannelManager;
 use parking_lot::RwLock;
 use snafu::OptionExt;
+use tonic::codec::CompressionEncoding;
 use tonic::transport::Channel;
 
 use crate::load_balance::{LoadBalance, Loadbalancer};
@@ -36,22 +37,73 @@ pub struct Client {
     inner: Arc<Inner>,
 }
 
+#[derive(Default)]
+pub struct ClientBuilder {
+    channel_manager: ChannelManager,
+    load_balance: Loadbalancer,
+    compression: Compression,
+    peers: Arc<RwLock<Vec<String>>>,
+}
+
+impl ClientBuilder {
+    pub fn channel_manager(mut self, channel_manager: ChannelManager) -> Self {
+        self.channel_manager = channel_manager;
+        self
+    }
+
+    pub fn load_balance(mut self, load_balance: Loadbalancer) -> Self {
+        self.load_balance = load_balance;
+        self
+    }
+
+    pub fn compression(mut self, compression: Compression) -> Self {
+        self.compression = compression;
+        self
+    }
+
+    pub fn peers<U, A>(mut self, peers: A) -> Self
+    where
+        U: AsRef<str>,
+        A: AsRef<[U]>,
+    {
+        self.peers = Arc::new(RwLock::new(normailze_urls(peers)));
+        self
+    }
+
+    pub fn build(self) -> Client {
+        let inner = InnerBuilder::default()
+            .channel_manager(self.channel_manager)
+            .load_balance(self.load_balance)
+            .compression(self.compression)
+            .build();
+        Client {
+            inner: Arc::new(inner),
+        }
+    }
+}
+
+#[derive(Debug, Clone)]
+pub enum Compression {
+    Gzip,
+    Zstd,
+    Plain,
+}
+
+impl Default for Compression {
+    fn default() -> Self {
+        Self::Gzip
+    }
+}
+
 #[derive(Debug, Default)]
 struct Inner {
     channel_manager: ChannelManager,
     peers: Arc<RwLock<Vec<String>>>,
     load_balance: Loadbalancer,
+    compression: Compression,
 }
 
 impl Inner {
-    fn with_manager(channel_manager: ChannelManager) -> Self {
-        Self {
-            channel_manager,
-            peers: Default::default(),
-            load_balance: Default::default(),
-        }
-    }
-
     fn set_peers(&self, peers: Vec<String>) {
         let mut guard = self.peers.write();
         *guard = peers;
@@ -63,51 +115,97 @@ impl Inner {
     }
 }
 
+#[derive(Default)]
+pub struct InnerBuilder {
+    channel_manager: ChannelManager,
+    load_balance: Loadbalancer,
+    compression: Compression,
+    peers: Arc<RwLock<Vec<String>>>,
+}
+
+impl InnerBuilder {
+    pub(self) fn channel_manager(mut self, channel_manager: ChannelManager) -> Self {
+        self.channel_manager = channel_manager;
+        self
+    }
+
+    pub(self) fn load_balance(mut self, load_balance: Loadbalancer) -> Self {
+        self.load_balance = load_balance;
+        self
+    }
+
+    pub(self) fn compression(mut self, compression: Compression) -> Self {
+        self.compression = compression;
+        self
+    }
+
+    pub(self) fn peers<U, A>(mut self, peers: A) -> Self
+    where
+        U: AsRef<str>,
+        A: AsRef<[U]>,
+    {
+        self.peers = Arc::new(RwLock::new(normailze_urls(peers)));
+        self
+    }
+
+    pub(self) fn build(self) -> Inner {
+        Inner {
+            channel_manager: self.channel_manager,
+            load_balance: self.load_balance,
+            compression: self.compression,
+            peers: self.peers,
+        }
+    }
+}
+
 impl Client {
+    #[deprecated(since = "0.1.0", note = "use `ClientBuilder` instead of this method")]
     pub fn new() -> Self {
         Default::default()
     }
 
+    #[deprecated(since = "0.1.0", note = "use `ClientBuilder` instead of this method")]
     pub fn with_manager(channel_manager: ChannelManager) -> Self {
-        let inner = Arc::new(Inner::with_manager(channel_manager));
-        Self { inner }
+        let inner = InnerBuilder::default()
+            .channel_manager(channel_manager)
+            .build();
+        Self {
+            inner: Arc::new(inner),
+        }
     }
 
+    #[deprecated(since = "0.1.0", note = "use `ClientBuilder` instead of this method")]
     pub fn with_urls<U, A>(urls: A) -> Self
     where
         U: AsRef<str>,
         A: AsRef<[U]>,
     {
-        Self::with_manager_and_urls(ChannelManager::new(), urls)
+        ClientBuilder::default().peers(urls).build()
     }
 
+    #[deprecated(since = "0.1.0", note = "use `ClientBuilder` instead of this method")]
     pub fn with_manager_and_urls<U, A>(channel_manager: ChannelManager, urls: A) -> Self
     where
         U: AsRef<str>,
         A: AsRef<[U]>,
     {
-        let inner = Inner::with_manager(channel_manager);
-        let urls: Vec<String> = urls
-            .as_ref()
-            .iter()
-            .map(|peer| peer.as_ref().to_string())
-            .collect();
-        inner.set_peers(urls);
+        let inner = InnerBuilder::default()
+            .channel_manager(channel_manager)
+            .peers(urls)
+            .build();
+
         Self {
             inner: Arc::new(inner),
         }
     }
 
+    #[deprecated(since = "0.1.0", note = "should be removed in the future")]
     pub fn start<U, A>(&self, urls: A)
     where
         U: AsRef<str>,
         A: AsRef<[U]>,
     {
-        let urls: Vec<String> = urls
-            .as_ref()
-            .iter()
-            .map(|peer| peer.as_ref().to_string())
-            .collect();
+        let urls: Vec<String> = normailze_urls(urls);
 
         self.inner.set_peers(urls);
     }
@@ -127,8 +225,19 @@ impl Client {
 
     pub(crate) fn make_database_client(&self) -> Result<DatabaseClient> {
         let (_, channel) = self.find_channel()?;
-        let client =
-            GreptimeDatabaseClient::new(channel).max_decoding_message_size(MAX_MESSAGE_SIZE);
+        let mut client = GreptimeDatabaseClient::new(channel)
+            .max_decoding_message_size(MAX_MESSAGE_SIZE)
+            .accept_compressed(CompressionEncoding::Gzip)
+            .accept_compressed(CompressionEncoding::Zstd);
+        match self.inner.compression {
+            Compression::Gzip => {
+                client = client.send_compressed(CompressionEncoding::Gzip);
+            }
+            Compression::Zstd => {
+                client = client.send_compressed(CompressionEncoding::Zstd);
+            }
+            Compression::Plain => {}
+        }
         Ok(DatabaseClient { inner: client })
     }
 
@@ -140,6 +249,17 @@ impl Client {
     }
 }
 
+fn normailze_urls<U, A>(urls: A) -> Vec<String>
+where
+    U: AsRef<str>,
+    A: AsRef<[U]>,
+{
+    urls.as_ref()
+        .iter()
+        .map(|peer| peer.as_ref().to_string())
+        .collect()
+}
+
 #[cfg(test)]
 mod tests {
     use std::collections::HashSet;

src/lib.rs

@@ -22,7 +22,7 @@ pub mod load_balance;
 mod stream_insert;
 
 pub use self::channel_manager::{ChannelConfig, ChannelManager, ClientTlsOption};
-pub use self::client::Client;
+pub use self::client::{Client, ClientBuilder};
 pub use self::database::Database;
 pub use self::error::{Error, Result};
 pub use self::stream_insert::StreamInserter;

src/load_balance.rs

@@ -21,7 +21,7 @@ pub trait LoadBalance {
 }
 
 #[enum_dispatch(LoadBalance)]
-#[derive(Debug)]
+#[derive(Debug, Clone)]
 pub enum Loadbalancer {
     Random,
 }
@@ -32,7 +32,7 @@ impl Default for Loadbalancer {
     }
 }
 
-#[derive(Debug)]
+#[derive(Debug, Copy, Clone)]
 pub struct Random;
 
 impl LoadBalance for Random {