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

Execute the command on project directory.

$ cargo build

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

How to run sample

GridDB Server need to be started in advance.

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>

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:

The current API might be changed in the next version.
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.

griddb / rust_client