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.

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

QuickStart

Preparations

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

Install GridDB Server and C Client.

Install clang.

• Ubuntu 20.04 console $ sudo apt-get install clang-10 libclang-10-dev

• CentOS 7 console $ sudo yum install llvm-toolset-7.0 $ scl enable llvm-toolset-7.0 bash

Build and Run

1. Execute the command on project directory. console $ 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 LDLIBRARYPATH. console $ export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:<C client library file directory path>

2. The command to run sample

console $ 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 LDLIBRARYPATH.

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.