GridDB Rust 客户端

概述

GridDB Rust 客户端是 GridDB 的 Rust 编程语言客户端库。

它是使用 GridDB C 客户端和 Rust bindgen 开发的。

运行环境

已在该环境中检查了库的构建和示例程序的执行。

OS: Ubuntu 20.04/CentOS 7.9
Rust: 1.62
Clang: >=7
GridDB Server/C Client: 5.0 CE

快速入门

准备工作

安装 rust。

$ curl https://sh.rustup.rs -sSf | sh

安装 GridDB 服务器 和 C 客户端。

安装 clang。

• Ubuntu 20.04

  $ sudo apt-get install clang-10 libclang-10-dev 
  

• CentOS 7

  $ sudo yum install llvm-toolset-7.0
  $ scl enable llvm-toolset-7.0 bash
  

构建和运行

1. 在项目目录下执行命令。

$ cargo build

2. 在 Rust 源代码中使用 "extern crate griddb_rust;"。

如何运行示例

需要提前启动 GridDB 服务器。

1. 如果您从源代码构建 GridDB C 客户端，请设置 LD_LIBRARY_PATH。

  $ export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:<C client library file directory path>

2. 运行示例的命令

  $ cargo run --example sample1 <GridDB notification address> <GridDB notification port>
       <GridDB cluster name> <GridDB user> <GridDB password>
  --> Person: name=name01 status=false count=100 lob=[ABCDEFGHIJ]

功能

(可用)

• GridDB 的 STRING, BOOL, BYTE, SHORT, INTEGER, LONG, FLOAT, DOUBLE, TIMESTAMP, BLOB 类型
• 插入单行，通过键获取行
• 正常查询，使用 TQL 进行聚合

(不可用)

• GridDB 的 GEOMETRY, Array 类型
• 多-Put/Get/Query (批处理)
• 时间序列特定功能，亲和力

请参阅以下文件以获取更详细的信息。

• Rust 客户端 API 参考

注意

1. 当前 API 可能会在下一个版本中更改。
2. 当您使用 RPM 或 DEB 安装 C 客户端时，您不需要设置 LD_LIBRARY_PATH。

社区

• 问题
  如果您有任何请求、问题或错误报告，请使用 GitHub 问题功能。
• 拉取请求
  如果您想贡献代码，请使用 GitHub 拉取请求功能。您需要同意 GridDB 贡献者许可协议(CLA_rev1.1.pdf)。通过使用 GitHub 拉取请求功能，您应被视为已同意 GridDB 贡献者许可协议。

许可证

GridDB Rust 客户端源代码许可证是 Apache 许可证，版本 2.0。