Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/driftluo/InfluxDBClient-rs
A easy-use client to influxdb
https://github.com/driftluo/InfluxDBClient-rs
influxdb rust
Last synced: about 2 months ago
JSON representation
A easy-use client to influxdb
- Host: GitHub
- URL: https://github.com/driftluo/InfluxDBClient-rs
- Owner: driftluo
- License: mit
- Created: 2017-06-11T10:42:43.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-24T15:30:34.000Z (over 1 year ago)
- Last Synced: 2024-07-04T18:40:37.206Z (2 months ago)
- Topics: influxdb, rust
- Language: Rust
- Homepage: https://docs.rs/influx_db_client/
- Size: 107 KB
- Stars: 82
- Watchers: 4
- Forks: 37
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-cn - driftluo/InfluxDBClient-rs - ci.org/driftluo/InfluxDBClient-rs.svg?branch=master">](https://travis-ci.org/driftluo/InfluxDBClient-rs) (Libraries / Database)
- awesome-rust - driftluo/InfluxDBClient-rs - ci.org/driftluo/InfluxDBClient-rs.svg?branch=master">](https://travis-ci.org/driftluo/InfluxDBClient-rs) (Libraries / Database)
- awesome-rust - driftluo/InfluxDBClient-rs
- awesome-rust-cn - driftluo/InfluxDBClient-rs
- awesome-rust-zh - driftluo/InfluxDBClient-rs - 同步接口[<img src="https://api.travis-ci.org/driftluo/InfluxDBClient-rs.svg?branch=master">](https://travis-ci.org/driftluo/InfluxDBClient-rs) (库 / 数据库)
- awesome-rust - driftluo/InfluxDBClient-rs - Synchronization interface (Libraries / Database)
- awesome-rust - driftluo/InfluxDBClient-rs - ci.org/driftluo/InfluxDBClient-rs.svg?branch=master">](https://travis-ci.org/driftluo/InfluxDBClient-rs) (库 Libraries / 数据库 Database)
README
# InfluxDBClient-rs
[](https://travis-ci.org/driftluo/InfluxDBClient-rs)
A easy-use client to influxdb
## Overview
This is an InfluxDB driver for Rust.
## Status
This project has been able to run properly, PR is welcome.
## Usage
### Use
```
[dependencies]
influx_db_client = "^0.5.0"
```
### http
```Rust
use influx_db_client::{
Client, Point, Points, Value, Precision, point, points
};
use tokio;
fn main() {
// default with "http://127.0.0.1:8086", db with "test"
let client = Client::default().set_authentication("root", "root");
let point = point!("test1")
.add_field("foo", "bar")
.add_field("integer", 11)
.add_field("float", 22.3)
.add_field("'boolean'", false);
let point1 = Point::new("test1")
.add_tag("tags", "\\\"fda")
.add_tag("number", 12)
.add_tag("float", 12.6)
.add_field("fd", "'3'")
.add_field("quto", "\\\"fda")
.add_field("quto1", "\"fda");
let points = points!(point1, point);
tokio::runtime::Runtime::new().unwrap().block_on(async move {
// if Precision is None, the default is second
// Multiple write
client.write_points(points, Some(Precision::Seconds), None).await.unwrap();
// query, it's type is Option>
let res = client.query("select * from test1", None).await.unwrap();
println!("{:?}", res.unwrap()[0].series)
});
}
```
### udp
```Rust
use influx_db_client::{UdpClient, Point, Value, point};
fn main() {
let mut udp = UdpClient::new("127.0.0.1:8089");
udp.add_host("127.0.0.1:8090");
let point = point!("test").add_field("foo", Value::String(String::from("bar")));
udp.write_point(point).unwrap();
}
```
## Compatibility
This is the [API Document](https://docs.influxdata.com/influxdb/v1.2/tools/api/), it may apply to version 1.0 or higher.
I have tested it in version 1.0.2/1.3.5/1.5.
## Thanks
Because [**influent**](https://github.com/gobwas/influent.rs) seems to have no longer updated, and only support to the 0.9 version. I read **influent.rs** and [**influxdb-python**](https://github.com/influxdata/influxdb-python) source, and then try to write a library for 1.0+ version for support for my own use.