Awesome

GridDB Rust Client

Overview

GridDB Rust Client is GridDB client library for Rust Programing Language.

It is developed using GridDB C Client and Rust bindgen.

Operating environment

Building of the library and execution of the sample programs have been checked in the following environment.

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

QuickStart

Preparations

Install rust.

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

Install GridDB Server and C Client.

Install 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
  

Build and Run

1. Execute the command on project directory.

$ cargo build

2. Use "extern crate griddb_rust;" in Rust source code.

How to run sample

GridDB Server need to be started in advance.

1. If you build GridDB C Client from source code, set LD_LIBRARY_PATH.

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

2. The command to run sample

  $ 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]

Function

(available)

• STRING, BOOL, BYTE, SHORT, INTEGER, LONG, FLOAT, DOUBLE, TIMESTAMP, BLOB type for GridDB
• Put single row, get row with key
• Normal query, aggregation with TQL

(not available)

• GEOMETRY, Array type for GridDB
• Multi-Put/Get/Query (batch processing)
• Timeseries-specific function, affinity

Please refer to the following files for more detailed information.

• Rust Client API Reference

Note:

1. The current API might be changed in the next version.
2. When you install C Client with RPM or DEB, you don't need to set LD_LIBRARY_PATH.

Community

• Issues
  Use the GitHub issue function if you have any requests, questions, or bug reports.
• PullRequest
  Use the GitHub pull request function if you want to contribute code. You'll need to agree GridDB Contributor License Agreement(CLA_rev1.1.pdf). By using the GitHub pull request function, you shall be deemed to have agreed to GridDB Contributor License Agreement.

License

GridDB Rust Client source license is Apache License, version 2.0.