You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This repository contains the reference JVM clients for the InfluxDB 2.0. Currently, Java, Reactive, Kotlin and Scala clients are implemented.
12
+
This repository contains the reference JVM clients for the InfluxDB 2.x. Currently, Java, Reactive, Kotlin and Scala clients are implemented.
13
13
14
14
#### Note: Use this client library with InfluxDB 2.x and InfluxDB 1.8+ ([see details](#influxdb-18-api-compatibility)). For connecting to InfluxDB 1.7 or earlier instances, use the [influxdb-java](https://github.com/influxdata/influxdb-java) client library.
15
15
16
16
-[Features](#features)
17
17
-[Clients](#clients)
18
18
-[How To Use](#how-to-use)
19
-
-[Writes and Queries in InfluxDB 2.0](#writes-and-queries-in-influxdb-20)
20
-
-[Use Management API to create a new Bucket in InfluxDB 2.0](#use-management-api-to-create-a-new-bucket-in-influxdb-20)
19
+
-[Writes and Queries in InfluxDB 2.x](#writes-and-queries-in-influxdb-2x)
20
+
-[Use Management API to create a new Bucket in InfluxDB 2.x](#use-management-api-to-create-a-new-bucket-in-influxdb-2x)
21
21
-[Flux queries in InfluxDB 1.7+](#flux-queries-in-influxdb-17)
22
22
-[Build Requirements](#build-requirements)
23
23
-[Contributing](#contributing)
@@ -27,20 +27,20 @@ This repository contains the reference JVM clients for the InfluxDB 2.0. Current
27
27
28
28
This section contains links to the client library documentation.
|**[java](./client)**| The reference Java client that allows query, write and InfluxDB 2.0 management. |[javadoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-java/apidocs/index.html), [readme](./client#influxdb-client-java/)| 2.0|
58
-
|**[reactive](./client-reactive)**| The reference RxJava client for the InfluxDB 2.0 that allows query and write in a reactive way.|[javadoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-reactive/apidocs/index.html), [readme](./client-reactive#influxdb-client-reactive/)|2.0|
59
-
|**[kotlin](./client-kotlin)**| The reference Kotlin client that allows query and write for the InfluxDB 2.0 by Kotlin [Channel](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.channels/-channel/index.html) and [Flow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html) coroutines. |[KDoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-kotlin/dokka/influxdb-client-kotlin/com.influxdb.client.kotlin/index.html), [readme](./client-kotlin#influxdb-client-kotlin/)| 2.0|
60
-
|**[scala](./client-scala)**| The reference Scala client that allows query and write for the InfluxDB 2.0 by [Akka Streams](https://doc.akka.io/docs/akka/2.6/stream/). |[Scaladoc](https://influxdata.github.io/influxdb-client-java/client-scala/cross/influxdb-client-scala_2.13/scaladocs/com/influxdb/client/scala/index.html), [readme](./client-scala#influxdb-client-scala/)| 2.0|
61
-
|**[osgi](./client-osgi)**| The reference OSGi (R6) client embedding Java and reactive clients and providing standard features (declarative services, configuration, event processing) for the InfluxDB 2.0. |[javadoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-osgi/apidocs/index.html), [readme](./client-osgi)| 2.0|
62
-
|**[karaf](./karaf)**| The Apache Karaf feature definition for the InfluxDB 2.0. |[readme](./karaf)| 2.0|
57
+
|**[java](./client)**| The reference Java client that allows query, write and InfluxDB 2.x management. |[javadoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-java/apidocs/index.html), [readme](./client#influxdb-client-java/)| 2.x|
58
+
|**[reactive](./client-reactive)**| The reference RxJava client for the InfluxDB 2.x that allows query and write in a reactive way.|[javadoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-reactive/apidocs/index.html), [readme](./client-reactive#influxdb-client-reactive/)|2.x|
59
+
|**[kotlin](./client-kotlin)**| The reference Kotlin client that allows query and write for the InfluxDB 2.x by Kotlin [Channel](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.channels/-channel/index.html) and [Flow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html) coroutines. |[KDoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-kotlin/dokka/influxdb-client-kotlin/com.influxdb.client.kotlin/index.html), [readme](./client-kotlin#influxdb-client-kotlin/)| 2.x|
60
+
|**[scala](./client-scala)**| The reference Scala client that allows query and write for the InfluxDB 2.x by [Akka Streams](https://doc.akka.io/docs/akka/2.6/stream/). |[Scaladoc](https://influxdata.github.io/influxdb-client-java/client-scala/cross/influxdb-client-scala_2.13/scaladocs/com/influxdb/client/scala/index.html), [readme](./client-scala#influxdb-client-scala/)| 2.x|
61
+
|**[osgi](./client-osgi)**| The reference OSGi (R6) client embedding Java and reactive clients and providing standard features (declarative services, configuration, event processing) for the InfluxDB 2.x. |[javadoc](https://influxdata.github.io/influxdb-client-java/influxdb-client-osgi/apidocs/index.html), [readme](./client-osgi)| 2.x|
62
+
|**[karaf](./karaf)**| The Apache Karaf feature definition for the InfluxDB 2.x. |[readme](./karaf)| 2.x|
63
63
64
64
There is also possibility to use the Flux language over the InfluxDB 1.7+ provided by:
|**[flux-dsl](./flux-dsl)**| A Java query builder for the Flux language |[javadoc](https://influxdata.github.io/influxdb-client-java/flux-dsl/apidocs/index.html), [readme](./flux-dsl#flux-dsl/)| 1.7+, 2.0|
81
+
|**[flux-dsl](./flux-dsl)**| A Java query builder for the Flux language |[javadoc](https://influxdata.github.io/influxdb-client-java/flux-dsl/apidocs/index.html), [readme](./flux-dsl#flux-dsl/)| 1.7+, 2.x|
82
82
83
83
84
84
## How To Use
@@ -87,9 +87,9 @@ This clients are hosted in Maven central Repository.
87
87
88
88
If you want to use it with the Maven, you have to add only the dependency on the artifact.
89
89
90
-
### Writes and Queries in InfluxDB 2.0
90
+
### Writes and Queries in InfluxDB 2.x
91
91
92
-
The following example demonstrates how to write data to InfluxDB 2.0 and read them back using the Flux language.
92
+
The following example demonstrates how to write data to InfluxDB 2.x and read them back using the Flux language.
93
93
94
94
#### Installation
95
95
@@ -203,9 +203,9 @@ public class InfluxDB2Example {
203
203
}
204
204
```
205
205
206
-
### Use Management API to create a new Bucket in InfluxDB 2.0
206
+
### Use Management API to create a new Bucket in InfluxDB 2.x
207
207
208
-
The following example demonstrates how to use a InfluxDB 2.0 Management API. For further information see [client documentation](./client#management-api).
208
+
The following example demonstrates how to use a InfluxDB 2.x Management API. For further information see [client documentation](./client#management-api).
209
209
210
210
#### Installation
211
211
@@ -292,14 +292,14 @@ public class InfluxDB2ManagementExample {
292
292
293
293
### InfluxDB 1.8 API compatibility
294
294
295
-
[InfluxDB 1.8.0 introduced forward compatibility APIs](https://docs.influxdata.com/influxdb/v1.8/tools/api/#influxdb-2-0-api-compatibility-endpoints) for InfluxDB 2.0. This allow you to easily move from InfluxDB 1.x to InfluxDB 2.0 Cloud or open source.
295
+
[InfluxDB 1.8.0 introduced forward compatibility APIs](https://docs.influxdata.com/influxdb/v1.8/tools/api/#influxdb-2-0-api-compatibility-endpoints) for InfluxDB 2.x. This allow you to easily move from InfluxDB 1.x to InfluxDB 2.x Cloud or open source.
296
296
297
297
The following forward compatible APIs are available:
298
298
299
299
| API | Endpoint | Description |
300
300
|:----------|:----------|:----------|
301
-
|[QueryApi.java](client/src/main/java/com/influxdb/client/QueryApi.java)|[/api/v2/query](https://docs.influxdata.com/influxdb/latest/tools/api/#api-v2-query-http-endpoint)| Query data in InfluxDB 1.8.0+ using the InfluxDB 2.0 API and [Flux](https://docs.influxdata.com/flux/latest/)_(endpoint should be enabled by [`flux-enabled` option](https://docs.influxdata.com/influxdb/latest/administration/config/#flux-enabled-false))_|
302
-
|[WriteApi.java](client/src/main/java/com/influxdb/client/WriteApi.java)|[/api/v2/write](https://docs.influxdata.com/influxdb/latest/tools/api/#api-v2-write-http-endpoint)| Write data to InfluxDB 1.8.0+ using the InfluxDB 2.0 API |
301
+
|[QueryApi.java](client/src/main/java/com/influxdb/client/QueryApi.java)|[/api/v2/query](https://docs.influxdata.com/influxdb/latest/tools/api/#api-v2-query-http-endpoint)| Query data in InfluxDB 1.8.0+ using the InfluxDB 2.x API and [Flux](https://docs.influxdata.com/flux/latest/)_(endpoint should be enabled by [`flux-enabled` option](https://docs.influxdata.com/influxdb/latest/administration/config/#flux-enabled-false))_|
302
+
|[WriteApi.java](client/src/main/java/com/influxdb/client/WriteApi.java)|[/api/v2/write](https://docs.influxdata.com/influxdb/latest/tools/api/#api-v2-write-http-endpoint)| Write data to InfluxDB 1.8.0+ using the InfluxDB 2.x API |
303
303
|[health()](client/src/main/java/com/influxdb/client/InfluxDBClient.java#L236)|[/health](https://docs.influxdata.com/influxdb/latest/tools/api/#health-http-endpoint)| Check the health of your InfluxDB instance |
304
304
305
305
For detail info see [InfluxDB 1.8 example](examples/src/main/java/example/InfluxDB18Example.java).
@@ -395,7 +395,7 @@ public class FluxExample {
395
395
* Java 1.8+ (tested with jdk8)
396
396
* Maven 3.0+ (tested with maven 3.5.0)
397
397
* Docker daemon running
398
-
* The latest InfluxDB 2.0 and InfluxDB 1.X docker instances, which can be started using the `./scripts/influxdb-restart.sh` script
398
+
* The latest InfluxDB 2.x and InfluxDB 1.X docker instances, which can be started using the `./scripts/influxdb-restart.sh` script
399
399
400
400
401
401
Once these are in place you can build influxdb-client-java with all tests with:
@@ -429,4 +429,4 @@ If you would like to contribute code you can do through GitHub by forking the re
429
429
430
430
## License
431
431
432
-
The InfluxDB 2.0 JVM Based Clients are released under the [MIT License](https://opensource.org/licenses/MIT).
432
+
The InfluxDB 2.x JVM Based Clients are released under the [MIT License](https://opensource.org/licenses/MIT).
The reference reactive Java client for InfluxDB 2.0. The client provide supports for asynchronous stream processing with backpressure as is defined by the [Reactive Streams specification](http://www.reactive-streams.org/).
5
+
The reference reactive Java client for InfluxDB 2.x. The client provide supports for asynchronous stream processing with backpressure as is defined by the [Reactive Streams specification](http://www.reactive-streams.org/).
6
6
7
7
## Important
8
8
@@ -13,7 +13,7 @@ That means no request to InfluxDB is trigger until register a subscription to `P
13
13
14
14
This section contains links to the client library documentation.
0 commit comments