请参阅示例。

功能标志

• lz4（默认启用）— 启用 Compression::Lz4 和 Compression::Lz4Hc(_) 变体。如果启用，默认情况下，除了 WATCH 外的所有查询都使用 Compression::Lz4。
• native-tls — 通过 hyper-tls 支持带有 HTTPS 架构的 URL，该架构链接到 OpenSSL。
• rustls-tls — 通过 hyper-rustls 支持带有 HTTPS 架构的 URL，该架构不链接到 OpenSSL。
• inserter — 启用 client.inserter()。
• test-util — 添加模拟。请参阅示例。仅在 dev-dependencies 中使用。
• watch — 启用 client.watch 功能。请参阅相应的部分以获取详细信息。
• uuid — 将 serde::uuid 添加到与 uuid 包一起使用。
• time — 将 serde::time 添加到与 time 包一起使用。

注意：当通过 HTTPS URL 连接到 ClickHouse 时，您必须启用 native-tls 或 rustls-tls 功能。如果两者都启用，则 rustls-tls 功能将优先。

数据类型

• (U)Int(8|16|32|64|128) 映射到/从相应的 (u|i)(8|16|32|64|128) 类型或它们周围的新类型。

• (U)Int256 不直接支持，但有一个解决方案。

• Float(32|64) 映射到/从相应的 f(32|64) 或它们周围的新类型。

• Decimal(32|64|128) 可以映射到/从相应的 i(32|64|128) 或其周围的 newtypes。使用 fixnum 或其他有符号定点数的实现更为方便。

• Boolean 可以映射到/从 bool 或其周围的 newtypes。

• String 可以映射到/从任何字符串或字节类型，例如 &str、&[u8]、String、Vec<u8> 或 SmartString。也支持 newtypes。为了存储字节，请考虑使用 serde_bytes，因为它更高效。

  示例

  #[derive(Row, Debug, Serialize, Deserialize)]
  struct MyRow<'a> {
      str: &'a str,
      string: String,
      #[serde(with = "serde_bytes")]
      bytes: Vec<u8>,
      #[serde(with = "serde_bytes")]
      byte_slice: &'a [u8],
  }
  

• FixedString(_) 目前还不支持。

• Enum(8|16) 使用 serde_repr 支持。

  示例

  use serde_repr::{Deserialize_repr, Serialize_repr};
  
  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      level: Level,
  }
  
  #[derive(Debug, Serialize_repr, Deserialize_repr)]
  #[repr(u8)]
  enum Level {
      Debug = 1,
      Info = 2,
      Warn = 3,
      Error = 4,
  }
  

• UUID 通过使用 serde::uuid 映射到/从 uuid::Uuid。需要 uuid 功能。

  示例

  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      #[serde(with = "clickhouse::serde::uuid")]
      uuid: uuid::Uuid,
  }
  

• IPv6 通过使用 serde::ipv4 映射到/从 std::net::Ipv6Addr。

• IPv4 通过使用 serde::ipv4 映射到/从 std::net::Ipv4Addr。

  示例

  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      #[serde(with = "clickhouse::serde::ipv4")]
      ipv4: std::net::Ipv4Addr,
  }
  

• Date 可以映射到/从 u16 或其周围的 newtypes，表示自 1970-01-01 以来经过的天数。此外，通过使用 serde::time::date 支持使用 time::Date，这需要 time 功能。

  示例

  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      days: u16,
      #[serde(with = "clickhouse::serde::time::date")]
      date: Date,
  }
  

• Date32 映射到/从 i32 或其新的类型，代表自 1970-01-01 以来经过的天数。此外，使用 serde::time::date32 支持使用 time::Date，需要 time 功能。

  示例

  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      days: i32,
      #[serde(with = "clickhouse::serde::time::date32")]
      date: Date,
  }
  

• DateTime 映射到/从 u32 或其新的类型，代表自 UNIX 纪元以来经过的秒数。此外，使用 serde::time::datetime 支持使用 time::OffsetDateTime，需要 time 功能。

  示例

  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      ts: u32,
      #[serde(with = "clickhouse::serde::time::datetime")]
      dt: OffsetDateTime,
  }
  

• DateTime64(_) 映射到/从 i32 或其新的类型，代表自 UNIX 纪元以来经过的时间。此外，使用 serde::time::datetime64::* 支持使用 time::OffsetDateTime，需要 time 功能。

  示例

  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      ts: i64, // elapsed s/us/ms/ns depending on `DateTime64(X)`
      #[serde(with = "clickhouse::serde::time::datetime64::secs")]
      dt64s: OffsetDateTime,  // `DateTime64(0)`
      #[serde(with = "clickhouse::serde::time::datetime64::millis")]
      dt64ms: OffsetDateTime, // `DateTime64(3)`
      #[serde(with = "clickhouse::serde::time::datetime64::micros")]
      dt64us: OffsetDateTime, // `DateTime64(6)`
      #[serde(with = "clickhouse::serde::time::datetime64::nanos")]
      dt64ns: OffsetDateTime, // `DateTime64(9)`
  }
  

• Typle(A, B, ...) 映射到/从 (A, B, ...) 或其新的类型。

• Array(_) 映射到/从任何切片，例如 Vec<_>，&[_]。也支持新的类型。

• Map(K, V) 的行为类似于 Array((K, V))。

• LowCardinality(_) 可以无缝支持。

• Nullable(_) 映射到/从 Option<_>。对于 clickhouse::serde::* 辅助函数添加 ::option。

  示例

  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      #[serde(with = "clickhouse::serde::ipv4::option")]
      ipv4_opt: Option<Ipv4Addr>,
  }
  

• Nested 通过提供多个具有重命名的数组来支持。

  示例

  // CREATE TABLE test(items Nested(name String, count UInt32))
  #[derive(Row, Serialize, Deserialize)]
  struct MyRow {
      #[serde(rename = "items.name")]
      items_name: Vec<String>,
      #[serde(rename = "items.count")]
      items_count: Vec<u32>,
  }
  

• 目前不支持 JSON 和 Geo。