From 8af253f222cc23842f5fd936874377f21f991e7f Mon Sep 17 00:00:00 2001 From: Leto_b Date: Wed, 25 Mar 2026 12:31:29 +0800 Subject: [PATCH] Programming-Go-Native-API_apache.md --- .../Table/API/Programming-CSharp-Native-API_apache.md | 1 + .../Table/API/Programming-CSharp-Native-API_timecho.md | 1 + .../Master/Table/API/Programming-Cpp-Native-API_apache.md | 5 +++-- .../Table/API/Programming-Cpp-Native-API_timecho.md | 5 +++-- .../Master/Table/API/Programming-Go-Native-API_apache.md | 1 + .../Master/Table/API/Programming-Go-Native-API_timecho.md | 1 + src/UserGuide/Master/Table/API/Programming-JDBC_apache.md | 7 ++++--- .../Master/Table/API/Programming-JDBC_timecho.md | 3 ++- .../Table/API/Programming-Java-Native-API_apache.md | 1 + .../Table/API/Programming-Java-Native-API_timecho.md | 1 + .../Table/API/Programming-Python-Native-API_apache.md | 1 + .../Table/API/Programming-Python-Native-API_timecho.md | 1 + .../Master/Tree/API/Programming-CSharp-Native-API.md | 1 + .../Master/Tree/API/Programming-Cpp-Native-API.md | 5 +++-- .../Tree/API/Programming-Data-Subscription_apache.md | 1 + .../Tree/API/Programming-Data-Subscription_timecho.md | 1 + .../Master/Tree/API/Programming-Go-Native-API.md | 2 ++ src/UserGuide/Master/Tree/API/Programming-JDBC_apache.md | 3 ++- src/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md | 3 ++- .../Master/Tree/API/Programming-Java-Native-API_apache.md | 1 + .../Tree/API/Programming-Java-Native-API_timecho.md | 1 + .../Tree/API/Programming-Python-Native-API_apache.md | 2 ++ .../Tree/API/Programming-Python-Native-API_timecho.md | 2 ++ .../API/Programming-CSharp-Native-API_apache.md | 1 + .../API/Programming-CSharp-Native-API_timecho.md | 1 + .../latest-Table/API/Programming-Cpp-Native-API_apache.md | 5 +++-- .../API/Programming-Cpp-Native-API_timecho.md | 5 +++-- .../latest-Table/API/Programming-Go-Native-API_apache.md | 1 + .../latest-Table/API/Programming-Go-Native-API_timecho.md | 1 + src/UserGuide/latest-Table/API/Programming-JDBC_apache.md | 1 + .../latest-Table/API/Programming-JDBC_timecho.md | 1 + .../API/Programming-Java-Native-API_apache.md | 1 + .../API/Programming-Java-Native-API_timecho.md | 1 + .../API/Programming-Python-Native-API_apache.md | 1 + .../API/Programming-Python-Native-API_timecho.md | 1 + src/UserGuide/latest/API/Programming-CSharp-Native-API.md | 1 + src/UserGuide/latest/API/Programming-Cpp-Native-API.md | 5 +++-- .../latest/API/Programming-Data-Subscription_apache.md | 1 + .../latest/API/Programming-Data-Subscription_timecho.md | 1 + src/UserGuide/latest/API/Programming-Go-Native-API.md | 2 ++ src/UserGuide/latest/API/Programming-JDBC_apache.md | 3 ++- src/UserGuide/latest/API/Programming-JDBC_timecho.md | 3 ++- .../latest/API/Programming-Java-Native-API_apache.md | 1 + .../latest/API/Programming-Java-Native-API_timecho.md | 1 + .../latest/API/Programming-Python-Native-API_apache.md | 2 ++ .../latest/API/Programming-Python-Native-API_timecho.md | 2 ++ .../Table/API/Programming-CSharp-Native-API_apache.md | 1 + .../Table/API/Programming-CSharp-Native-API_timecho.md | 1 + .../Master/Table/API/Programming-Cpp-Native-API_apache.md | 6 ++++-- .../Table/API/Programming-Cpp-Native-API_timecho.md | 8 +++++--- .../Master/Table/API/Programming-Go-Native-API_apache.md | 1 + .../Master/Table/API/Programming-Go-Native-API_timecho.md | 1 + .../UserGuide/Master/Table/API/Programming-JDBC_apache.md | 3 ++- .../Master/Table/API/Programming-JDBC_timecho.md | 1 + .../Table/API/Programming-Java-Native-API_apache.md | 1 + .../Table/API/Programming-Java-Native-API_timecho.md | 1 + .../Table/API/Programming-Python-Native-API_apache.md | 3 ++- .../Table/API/Programming-Python-Native-API_timecho.md | 3 ++- .../Master/Tree/API/Programming-CSharp-Native-API.md | 1 + .../Master/Tree/API/Programming-Cpp-Native-API.md | 7 ++++--- .../Tree/API/Programming-Data-Subscription_apache.md | 1 + .../Tree/API/Programming-Data-Subscription_timecho.md | 1 + .../Master/Tree/API/Programming-Go-Native-API.md | 2 ++ .../UserGuide/Master/Tree/API/Programming-JDBC_apache.md | 4 +++- .../UserGuide/Master/Tree/API/Programming-JDBC_timecho.md | 6 ++++-- .../Master/Tree/API/Programming-Java-Native-API_apache.md | 3 ++- .../Tree/API/Programming-Java-Native-API_timecho.md | 3 ++- .../Tree/API/Programming-Python-Native-API_apache.md | 4 ++++ .../Tree/API/Programming-Python-Native-API_timecho.md | 3 +++ .../API/Programming-CSharp-Native-API_apache.md | 1 + .../API/Programming-CSharp-Native-API_timecho.md | 1 + .../latest-Table/API/Programming-Cpp-Native-API_apache.md | 5 +++-- .../API/Programming-Cpp-Native-API_timecho.md | 7 ++++--- .../latest-Table/API/Programming-Go-Native-API_apache.md | 1 + .../latest-Table/API/Programming-Go-Native-API_timecho.md | 1 + .../UserGuide/latest-Table/API/Programming-JDBC_apache.md | 1 + .../latest-Table/API/Programming-JDBC_timecho.md | 1 + .../API/Programming-Java-Native-API_apache.md | 1 + .../API/Programming-Java-Native-API_timecho.md | 1 + .../API/Programming-Python-Native-API_apache.md | 3 ++- .../API/Programming-Python-Native-API_timecho.md | 3 ++- .../UserGuide/latest/API/Programming-CSharp-Native-API.md | 1 + src/zh/UserGuide/latest/API/Programming-Cpp-Native-API.md | 7 ++++--- .../latest/API/Programming-Data-Subscription_apache.md | 1 + .../latest/API/Programming-Data-Subscription_timecho.md | 1 + src/zh/UserGuide/latest/API/Programming-Go-Native-API.md | 2 ++ src/zh/UserGuide/latest/API/Programming-JDBC_apache.md | 4 +++- src/zh/UserGuide/latest/API/Programming-JDBC_timecho.md | 6 ++++-- .../latest/API/Programming-Java-Native-API_apache.md | 3 ++- .../latest/API/Programming-Java-Native-API_timecho.md | 3 ++- .../latest/API/Programming-Python-Native-API_apache.md | 4 ++++ .../latest/API/Programming-Python-Native-API_timecho.md | 3 +++ 92 files changed, 167 insertions(+), 51 deletions(-) diff --git a/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md b/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md index 9f2f5cf7d..1da03fc60 100644 --- a/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md +++ b/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md @@ -41,6 +41,7 @@ If using .NET 5.0 or a later version of the SDK, enter the following command to ```Plain dotnet add package Apache.IoTDB ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read/Write Operations diff --git a/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md b/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md index fc89b0c2d..7c515df99 100644 --- a/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md +++ b/src/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md @@ -41,6 +41,7 @@ If using .NET 5.0 or a later version of the SDK, enter the following command to ```Plain dotnet add package Apache.IoTDB ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read/Write Operations diff --git a/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md b/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md index 2d4833ed0..933248646 100644 --- a/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md +++ b/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md @@ -96,10 +96,11 @@ Clone the source code from git: git clone https://github.com/apache/iotdb.git ``` -The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 1.3.2): +The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 2.0.6): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. Run Maven to compile in the IoTDB root directory: diff --git a/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md b/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md index c23e64cb9..9be6f1da9 100644 --- a/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md +++ b/src/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md @@ -96,10 +96,11 @@ Clone the source code from git: git clone https://github.com/apache/iotdb.git ``` -The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 1.3.2): +The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 2.0.6): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. Run Maven to compile in the IoTDB root directory: diff --git a/src/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md b/src/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md index a0cbb6ff2..0d7cc4358 100644 --- a/src/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md +++ b/src/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md @@ -62,6 +62,7 @@ cd $GOPATH/src/iotdb-client-go-example/session_example curl -o session_example.go -L https://github.com/apache/iotdb-client-go/raw/main/example/session_example.go go run session_example.go ``` +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. ITableSession Interface ### 2.1 Description diff --git a/src/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md b/src/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md index c0d6afb8c..18fa3dc03 100644 --- a/src/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md +++ b/src/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md @@ -62,6 +62,7 @@ cd $GOPATH/src/iotdb-client-go-example/session_example curl -o session_example.go -L https://github.com/apache/iotdb-client-go/raw/main/example/session_example.go go run session_example.go ``` +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. ITableSession Interface ### 2.1 Description diff --git a/src/UserGuide/Master/Table/API/Programming-JDBC_apache.md b/src/UserGuide/Master/Table/API/Programming-JDBC_apache.md index 118e509f0..f1a062d37 100644 --- a/src/UserGuide/Master/Table/API/Programming-JDBC_apache.md +++ b/src/UserGuide/Master/Table/API/Programming-JDBC_apache.md @@ -44,6 +44,7 @@ Add the following dependency to your Maven `pom.xml` file: ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations @@ -66,13 +67,13 @@ Add the following dependency to your Maven `pom.xml` file: ## 3. Sample Code -**Note:** When using the Table Model, you must specify the `sql_dialect` parameter as `table` in the URL. Example: +**Note:** When using the Table Mode, you must specify the `sql_dialect` parameter as `table` in the URL. Example: ```Java String url = "jdbc:iotdb://127.0.0.1:6667?sql_dialect=table"; ``` -You can find the full example code at [GitHub Repository](https://github.com/apache/iotdb/blob/master/example/jdbc/src/main/java/org/apache/iotdb/TableModelJDBCExample.java). +You can find the full example code at [GitHub Repository](https://github.com/apache/iotdb/blob/rc/2.0.1/example/jdbc/src/main/java/org/apache/iotdb/TableModelJDBCExample.java). Here is an excerpt of the sample code: @@ -133,7 +134,7 @@ public class TableModelJDBCExample { "create table test1.table1(region_id STRING TAG, plant_id STRING TAG, device_id STRING TAG, model STRING ATTRIBUTE, temperature FLOAT FIELD, humidity DOUBLE FIELD) with (TTL=3600000)"); statement.execute( - "create table table2(region_id STRING TAG, plant_id STRING TAG, color STRING ATTRIBUTE, temperature FLOAT FIELD, speed DOUBLE FIELD) with (TTL=6600000)"); + "create table table2(region_id STRING ID, plant_id STRING ID, color STRING ATTRIBUTE, temperature FLOAT MEASUREMENT, speed DOUBLE MEASUREMENT) with (TTL=6600000)"); // show tables from current database try (ResultSet resultSet = statement.executeQuery("SHOW TABLES")) { diff --git a/src/UserGuide/Master/Table/API/Programming-JDBC_timecho.md b/src/UserGuide/Master/Table/API/Programming-JDBC_timecho.md index 5ef239cc9..6b85ccab2 100644 --- a/src/UserGuide/Master/Table/API/Programming-JDBC_timecho.md +++ b/src/UserGuide/Master/Table/API/Programming-JDBC_timecho.md @@ -44,6 +44,7 @@ Add the following dependency to your Maven `pom.xml` file: ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations @@ -66,7 +67,7 @@ Add the following dependency to your Maven `pom.xml` file: ## 3. Sample Code -**Note:** When using the Table Model, you must specify the `sql_dialect` parameter as `table` in the URL. Example: +**Note:** When using the Table Mode, you must specify the `sql_dialect` parameter as `table` in the URL. Example: ```Java String url = "jdbc:iotdb://127.0.0.1:6667?sql_dialect=table"; diff --git a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md index 07d2cf47c..42f813a83 100644 --- a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md +++ b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md @@ -44,6 +44,7 @@ IoTDB provides a Java native client driver and a session pool management mechani ``` * The latest version of `iotdb-session` can be viewed [here](https://repo1.maven.org/maven2/org/apache/iotdb/iotdb-session/) +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read and Write Operations diff --git a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md index 89805d8fd..ec19bf235 100644 --- a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md +++ b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md @@ -44,6 +44,7 @@ IoTDB provides a Java native client driver and a session pool management mechani ``` * The latest version of `iotdb-session` can be viewed [here](https://repo1.maven.org/maven2/com/timecho/iotdb/iotdb-session/) +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read and Write Operations diff --git a/src/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md b/src/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md index f2bc616c0..568102fb5 100644 --- a/src/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md +++ b/src/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md @@ -29,6 +29,7 @@ To use the IoTDB Python API, install the required package using pip: ```shell pip3 install apache-iotdb>=2.0 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations diff --git a/src/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md b/src/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md index 7e2fb95e5..7149b6dc8 100644 --- a/src/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md +++ b/src/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md @@ -29,6 +29,7 @@ To use the IoTDB Python API, install the required package using pip: ```shell pip3 install apache-iotdb>=2.0 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations diff --git a/src/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md b/src/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md index eab64cbab..9d5f2dbcf 100644 --- a/src/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md +++ b/src/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md @@ -48,6 +48,7 @@ To install an older version, specify the version explicitly # Install v0.12.1.2 dotnet add package Apache.IoTDB --version 0.12.1.2 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Quick Start diff --git a/src/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md b/src/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md index 35b5e2a20..607719617 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md +++ b/src/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md @@ -96,10 +96,11 @@ Clone the source code from git: git clone https://github.com/apache/iotdb.git ``` -The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 1.3.2): +The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 2.0.6): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. Run Maven to compile in the IoTDB root directory: diff --git a/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md b/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md index 91e21cb83..4751acaf2 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md +++ b/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md @@ -50,6 +50,7 @@ Create a Maven project and import the following dependencies(JDK >= 1.8, Maven ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Code Example diff --git a/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md b/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md index c49e12d6e..730ff8dc3 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md +++ b/src/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md @@ -50,6 +50,7 @@ Create a Maven project and import the following dependencies(JDK >= 1.8, Maven ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Code Example diff --git a/src/UserGuide/Master/Tree/API/Programming-Go-Native-API.md b/src/UserGuide/Master/Tree/API/Programming-Go-Native-API.md index 9004e9417..aa59bd24f 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Go-Native-API.md +++ b/src/UserGuide/Master/Tree/API/Programming-Go-Native-API.md @@ -86,6 +86,8 @@ This article focuses on the usage of `SessionPool`, covering the complete proces # Compile and run the program go run session_example.go ``` + +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Core Steps diff --git a/src/UserGuide/Master/Tree/API/Programming-JDBC_apache.md b/src/UserGuide/Master/Tree/API/Programming-JDBC_apache.md index 1a2902672..3ad8bdb19 100644 --- a/src/UserGuide/Master/Tree/API/Programming-JDBC_apache.md +++ b/src/UserGuide/Master/Tree/API/Programming-JDBC_apache.md @@ -44,10 +44,11 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb iotdb-jdbc - 1.3.1 + ${project.version} ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 4. Coding Examples diff --git a/src/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md b/src/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md index 782d7e9ab..5ed6af0b8 100644 --- a/src/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md +++ b/src/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md @@ -44,10 +44,11 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb iotdb-jdbc - 1.3.1 + ${project.version} ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 4. Coding Examples diff --git a/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md b/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md index efd98b457..d51e41233 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md +++ b/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md @@ -48,6 +48,7 @@ Create a Maven project and add the following dependencies to the pom.xml file (J ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Creating a Connection Pool Instance diff --git a/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md b/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md index d2fc66682..4912b411e 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md +++ b/src/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md @@ -48,6 +48,7 @@ Create a Maven project and add the following dependencies to the pom.xml file (J ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Creating a Connection Pool Instance diff --git a/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md b/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md index 1c8316507..df5123d32 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md +++ b/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md @@ -31,6 +31,8 @@ You have to install thrift (>=0.13) before using the package. First, download the package: `pip3 install apache-iotdb>=2.0` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. + You can get an example of using the package to read and write data at here:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) An example of aligned timeseries: [Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) diff --git a/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md b/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md index 8df2a7996..9a0ba39cd 100644 --- a/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md +++ b/src/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md @@ -31,6 +31,8 @@ You have to install thrift (>=0.13) before using the package. First, download the package: `pip3 install apache-iotdb>=2.0` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. + You can get an example of using the package to read and write data at here:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) An example of aligned timeseries: [Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) diff --git a/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md b/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md index 9f2f5cf7d..1da03fc60 100644 --- a/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md +++ b/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md @@ -41,6 +41,7 @@ If using .NET 5.0 or a later version of the SDK, enter the following command to ```Plain dotnet add package Apache.IoTDB ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read/Write Operations diff --git a/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md b/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md index fc89b0c2d..7c515df99 100644 --- a/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md +++ b/src/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md @@ -41,6 +41,7 @@ If using .NET 5.0 or a later version of the SDK, enter the following command to ```Plain dotnet add package Apache.IoTDB ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read/Write Operations diff --git a/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md b/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md index 2d4833ed0..933248646 100644 --- a/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md +++ b/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md @@ -96,10 +96,11 @@ Clone the source code from git: git clone https://github.com/apache/iotdb.git ``` -The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 1.3.2): +The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 2.0.6): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. Run Maven to compile in the IoTDB root directory: diff --git a/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md b/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md index c23e64cb9..9be6f1da9 100644 --- a/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md +++ b/src/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md @@ -96,10 +96,11 @@ Clone the source code from git: git clone https://github.com/apache/iotdb.git ``` -The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 1.3.2): +The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 2.0.6): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. Run Maven to compile in the IoTDB root directory: diff --git a/src/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md b/src/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md index a0cbb6ff2..0d7cc4358 100644 --- a/src/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md +++ b/src/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md @@ -62,6 +62,7 @@ cd $GOPATH/src/iotdb-client-go-example/session_example curl -o session_example.go -L https://github.com/apache/iotdb-client-go/raw/main/example/session_example.go go run session_example.go ``` +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. ITableSession Interface ### 2.1 Description diff --git a/src/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md b/src/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md index c0d6afb8c..18fa3dc03 100644 --- a/src/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md +++ b/src/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md @@ -62,6 +62,7 @@ cd $GOPATH/src/iotdb-client-go-example/session_example curl -o session_example.go -L https://github.com/apache/iotdb-client-go/raw/main/example/session_example.go go run session_example.go ``` +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. ITableSession Interface ### 2.1 Description diff --git a/src/UserGuide/latest-Table/API/Programming-JDBC_apache.md b/src/UserGuide/latest-Table/API/Programming-JDBC_apache.md index 1cc0c170d..f1a062d37 100644 --- a/src/UserGuide/latest-Table/API/Programming-JDBC_apache.md +++ b/src/UserGuide/latest-Table/API/Programming-JDBC_apache.md @@ -44,6 +44,7 @@ Add the following dependency to your Maven `pom.xml` file: ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations diff --git a/src/UserGuide/latest-Table/API/Programming-JDBC_timecho.md b/src/UserGuide/latest-Table/API/Programming-JDBC_timecho.md index e2ae883de..6b85ccab2 100644 --- a/src/UserGuide/latest-Table/API/Programming-JDBC_timecho.md +++ b/src/UserGuide/latest-Table/API/Programming-JDBC_timecho.md @@ -44,6 +44,7 @@ Add the following dependency to your Maven `pom.xml` file: ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations diff --git a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md index 07d2cf47c..42f813a83 100644 --- a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md +++ b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md @@ -44,6 +44,7 @@ IoTDB provides a Java native client driver and a session pool management mechani ``` * The latest version of `iotdb-session` can be viewed [here](https://repo1.maven.org/maven2/org/apache/iotdb/iotdb-session/) +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read and Write Operations diff --git a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md index 89805d8fd..ec19bf235 100644 --- a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md +++ b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md @@ -44,6 +44,7 @@ IoTDB provides a Java native client driver and a session pool management mechani ``` * The latest version of `iotdb-session` can be viewed [here](https://repo1.maven.org/maven2/com/timecho/iotdb/iotdb-session/) +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Read and Write Operations diff --git a/src/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md b/src/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md index f2bc616c0..568102fb5 100644 --- a/src/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md +++ b/src/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md @@ -29,6 +29,7 @@ To use the IoTDB Python API, install the required package using pip: ```shell pip3 install apache-iotdb>=2.0 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations diff --git a/src/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md b/src/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md index 7e2fb95e5..7149b6dc8 100644 --- a/src/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md +++ b/src/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md @@ -29,6 +29,7 @@ To use the IoTDB Python API, install the required package using pip: ```shell pip3 install apache-iotdb>=2.0 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Read and Write Operations diff --git a/src/UserGuide/latest/API/Programming-CSharp-Native-API.md b/src/UserGuide/latest/API/Programming-CSharp-Native-API.md index eab64cbab..9d5f2dbcf 100644 --- a/src/UserGuide/latest/API/Programming-CSharp-Native-API.md +++ b/src/UserGuide/latest/API/Programming-CSharp-Native-API.md @@ -48,6 +48,7 @@ To install an older version, specify the version explicitly # Install v0.12.1.2 dotnet add package Apache.IoTDB --version 0.12.1.2 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 3. Quick Start diff --git a/src/UserGuide/latest/API/Programming-Cpp-Native-API.md b/src/UserGuide/latest/API/Programming-Cpp-Native-API.md index 35b5e2a20..607719617 100644 --- a/src/UserGuide/latest/API/Programming-Cpp-Native-API.md +++ b/src/UserGuide/latest/API/Programming-Cpp-Native-API.md @@ -96,10 +96,11 @@ Clone the source code from git: git clone https://github.com/apache/iotdb.git ``` -The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 1.3.2): +The default main branch is the master branch. If you want to use a specific release version, switch to that branch (e.g., version 2.0.6): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. Run Maven to compile in the IoTDB root directory: diff --git a/src/UserGuide/latest/API/Programming-Data-Subscription_apache.md b/src/UserGuide/latest/API/Programming-Data-Subscription_apache.md index 91e21cb83..4751acaf2 100644 --- a/src/UserGuide/latest/API/Programming-Data-Subscription_apache.md +++ b/src/UserGuide/latest/API/Programming-Data-Subscription_apache.md @@ -50,6 +50,7 @@ Create a Maven project and import the following dependencies(JDK >= 1.8, Maven ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Code Example diff --git a/src/UserGuide/latest/API/Programming-Data-Subscription_timecho.md b/src/UserGuide/latest/API/Programming-Data-Subscription_timecho.md index c49e12d6e..730ff8dc3 100644 --- a/src/UserGuide/latest/API/Programming-Data-Subscription_timecho.md +++ b/src/UserGuide/latest/API/Programming-Data-Subscription_timecho.md @@ -50,6 +50,7 @@ Create a Maven project and import the following dependencies(JDK >= 1.8, Maven ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Code Example diff --git a/src/UserGuide/latest/API/Programming-Go-Native-API.md b/src/UserGuide/latest/API/Programming-Go-Native-API.md index 9004e9417..aa59bd24f 100644 --- a/src/UserGuide/latest/API/Programming-Go-Native-API.md +++ b/src/UserGuide/latest/API/Programming-Go-Native-API.md @@ -86,6 +86,8 @@ This article focuses on the usage of `SessionPool`, covering the complete proces # Compile and run the program go run session_example.go ``` + +* Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 2. Core Steps diff --git a/src/UserGuide/latest/API/Programming-JDBC_apache.md b/src/UserGuide/latest/API/Programming-JDBC_apache.md index 1a2902672..3ad8bdb19 100644 --- a/src/UserGuide/latest/API/Programming-JDBC_apache.md +++ b/src/UserGuide/latest/API/Programming-JDBC_apache.md @@ -44,10 +44,11 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb iotdb-jdbc - 1.3.1 + ${project.version} ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 4. Coding Examples diff --git a/src/UserGuide/latest/API/Programming-JDBC_timecho.md b/src/UserGuide/latest/API/Programming-JDBC_timecho.md index 782d7e9ab..5ed6af0b8 100644 --- a/src/UserGuide/latest/API/Programming-JDBC_timecho.md +++ b/src/UserGuide/latest/API/Programming-JDBC_timecho.md @@ -44,10 +44,11 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb iotdb-jdbc - 1.3.1 + ${project.version} ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ## 4. Coding Examples diff --git a/src/UserGuide/latest/API/Programming-Java-Native-API_apache.md b/src/UserGuide/latest/API/Programming-Java-Native-API_apache.md index efd98b457..d51e41233 100644 --- a/src/UserGuide/latest/API/Programming-Java-Native-API_apache.md +++ b/src/UserGuide/latest/API/Programming-Java-Native-API_apache.md @@ -48,6 +48,7 @@ Create a Maven project and add the following dependencies to the pom.xml file (J ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Creating a Connection Pool Instance diff --git a/src/UserGuide/latest/API/Programming-Java-Native-API_timecho.md b/src/UserGuide/latest/API/Programming-Java-Native-API_timecho.md index d2fc66682..4912b411e 100644 --- a/src/UserGuide/latest/API/Programming-Java-Native-API_timecho.md +++ b/src/UserGuide/latest/API/Programming-Java-Native-API_timecho.md @@ -48,6 +48,7 @@ Create a Maven project and add the following dependencies to the pom.xml file (J ``` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. ### 2.2 Creating a Connection Pool Instance diff --git a/src/UserGuide/latest/API/Programming-Python-Native-API_apache.md b/src/UserGuide/latest/API/Programming-Python-Native-API_apache.md index 1c8316507..df5123d32 100644 --- a/src/UserGuide/latest/API/Programming-Python-Native-API_apache.md +++ b/src/UserGuide/latest/API/Programming-Python-Native-API_apache.md @@ -31,6 +31,8 @@ You have to install thrift (>=0.13) before using the package. First, download the package: `pip3 install apache-iotdb>=2.0` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. + You can get an example of using the package to read and write data at here:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) An example of aligned timeseries: [Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) diff --git a/src/UserGuide/latest/API/Programming-Python-Native-API_timecho.md b/src/UserGuide/latest/API/Programming-Python-Native-API_timecho.md index 8df2a7996..9a0ba39cd 100644 --- a/src/UserGuide/latest/API/Programming-Python-Native-API_timecho.md +++ b/src/UserGuide/latest/API/Programming-Python-Native-API_timecho.md @@ -31,6 +31,8 @@ You have to install thrift (>=0.13) before using the package. First, download the package: `pip3 install apache-iotdb>=2.0` +Note: Do not use a newer client to connect to an older server, as this may cause connection failures or unexpected errors. + You can get an example of using the package to read and write data at here:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) An example of aligned timeseries: [Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) diff --git a/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md index b6ec99f11..959bf959a 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_apache.md @@ -41,6 +41,7 @@ IoTDB具备C#原生客户端驱动和对应的连接池,提供对象化接口 ```Plain dotnet add package Apache.IoTDB ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md index 00f9b5d13..0d1c44c6d 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-CSharp-Native-API_timecho.md @@ -41,6 +41,7 @@ IoTDB具备C#原生客户端驱动和对应的连接池,提供对象化接口 ```Plain dotnet add package Apache.IoTDB ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md index e4185fb3b..1d37b4f12 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_apache.md @@ -101,10 +101,11 @@ git clone https://github.com/apache/iotdb.git ``` -默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 1.3.2 版本): +默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 2.0.6 版本): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +注意:请勿使用高版本客户端连接低版本服务。 在 IoTDB 根目录下执行 maven 编译: @@ -276,6 +277,7 @@ void insertRelationalTablet() { for (int row = 0; row < 100; row++) { int rowIndex = tablet.rowSize++; tablet.timestamps[rowIndex] = row; + // 使用基于索引的 API 比通过列名查找更高效 // 推荐写法:tablet.addValue(0, rowIndex, "1"); // 避免写法:tablet.addValue("region_id", rowIndex, "1"); diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md index 36cae8a7a..be499eba7 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Cpp-Native-API_timecho.md @@ -101,10 +101,11 @@ git clone https://github.com/apache/iotdb.git ``` -默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 1.3.2 版本): +默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 2.0.6 版本): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +注意:请勿使用高版本客户端连接低版本服务。 在 IoTDB 根目录下执行 maven 编译: @@ -174,7 +175,7 @@ A: ### 3.1 TableSession 类 -C++ 客户端的操作均通过 TableSession 类进行,下面将给出 TableSession 接口中定义的方法说明。 +C++ 客户端的操作均通过 TableSession 类进行,下面将给出 TableSession 接口中定义的方法说明。 #### 3.1.1 方法列表 @@ -276,6 +277,7 @@ void insertRelationalTablet() { for (int row = 0; row < 100; row++) { int rowIndex = tablet.rowSize++; tablet.timestamps[rowIndex] = row; + // 使用基于索引的 API 比通过列名查找更高效 // 推荐写法:tablet.addValue(0, rowIndex, "1"); // 避免写法:tablet.addValue("region_id", rowIndex, "1"); diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md index 1b33ff1c1..2892a321a 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_apache.md @@ -82,6 +82,7 @@ go mod tidy # 编译并运行程序 go run session_example.go ``` +* 注意:请勿使用高版本客户端连接低版本服务。 ## 2. ITableSession 接口 ### 2.1 功能描述 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md index da1533a2e..8866227de 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Go-Native-API_timecho.md @@ -82,6 +82,7 @@ go mod tidy # 编译并运行程序 go run session_example.go ``` +* 注意:请勿使用高版本客户端连接低版本服务。 ## 2. ITableSession 接口 ### 2.1 功能描述 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-JDBC_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-JDBC_apache.md index 740a1d31d..f9ae1e4b7 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-JDBC_apache.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-JDBC_apache.md @@ -47,6 +47,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 @@ -76,7 +77,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互 String url = "jdbc:iotdb://127.0.0.1:6667?sql_dialect=table"; ``` -JDBC接口示例代码:[src/main/java/org/apache/iotdb/TableModelJDBCExample.java](https://github.com/apache/iotdb/blob/master/example/jdbc/src/main/java/org/apache/iotdb/TableModelJDBCExample.java) +JDBC接口示例代码:[src/main/java/org/apache/iotdb/TableModelJDBCExample.java](https://github.com/apache/iotdb/blob/rc/2.0.1/example/jdbc/src/main/java/org/apache/iotdb/TableModelJDBCExample.java) ```Java diff --git a/src/zh/UserGuide/Master/Table/API/Programming-JDBC_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-JDBC_timecho.md index 4bc3ea2bb..9484025d3 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-JDBC_timecho.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-JDBC_timecho.md @@ -47,6 +47,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md index ad3fc1905..d07763cdd 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md @@ -45,6 +45,7 @@ IoTDB具备Java原生客户端驱动和对应的连接池,提供对象化接 ``` * 可从[此处](https://repo1.maven.org/maven2/org/apache/iotdb/iotdb-session/)查看`iotdb-session`最新版本 +* 注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md index bb3134ee6..a17dab3c0 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md @@ -45,6 +45,7 @@ IoTDB具备Java原生客户端驱动和对应的连接池,提供对象化接 ``` * 可从[此处](https://repo1.maven.org/maven2/com/timecho/iotdb/iotdb-session/)查看`iotdb-session`最新版本 +* 注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md index 63953b310..eaf45591b 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_apache.md @@ -28,6 +28,7 @@ ```shell pip3 install apache-iotdb>=2.0 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 2. 读写操作 @@ -174,7 +175,7 @@ class TableSessionConfig(object): #### 3.1.1 功能描述 -TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 +TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 #### 3.1.2 方法列表 diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md index 2ebecf58e..af1119b53 100644 --- a/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md +++ b/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API_timecho.md @@ -28,6 +28,7 @@ ```shell pip3 install apache-iotdb>=2.0 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 2. 读写操作 @@ -174,7 +175,7 @@ class TableSessionConfig(object): #### 3.1.1 功能描述 -TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 +TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 #### 3.1.2 方法列表 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md b/src/zh/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md index 40f0b49b3..ed1652786 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-CSharp-Native-API.md @@ -43,6 +43,7 @@ dotnet add package Apache.IoTDB # 安装0.12.1.2版本的客户端 dotnet add package Apache.IoTDB --version 0.12.1.2 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 快速入门 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md b/src/zh/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md index 25b09db73..ace2fe347 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Cpp-Native-API.md @@ -101,10 +101,11 @@ git clone https://github.com/apache/iotdb.git ``` -默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 1.3.2 版本): +默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 2.0.6 版本): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +注意:请勿使用高版本客户端连接低版本服务。 在 IoTDB 根目录下执行 maven 编译: @@ -177,7 +178,7 @@ A: - 开启 Session ```cpp void open(); -``` +``` - 开启 Session,并决定是否开启 RPC 压缩 ```cpp diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md b/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md index aa103544a..81695dc8a 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_apache.md @@ -50,6 +50,7 @@ IoTDB 提供了强大的数据订阅功能,允许用户通过订阅 API 实时 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 代码案例 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md b/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md index a927d366c..183fdcc80 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Data-Subscription_timecho.md @@ -50,6 +50,7 @@ IoTDB 提供了强大的数据订阅功能,允许用户通过订阅 API 实时 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 代码案例 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Go-Native-API.md b/src/zh/UserGuide/Master/Tree/API/Programming-Go-Native-API.md index fe9e49b9b..db85841f9 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Go-Native-API.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Go-Native-API.md @@ -87,6 +87,8 @@ go mod tidy go run session_example.go ``` +* 注意:请勿使用高版本客户端连接低版本服务。 + ## 2. 核心步骤 使用 Go 原生接口操作 IoTDB 的三个核心步骤如下: diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_apache.md b/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_apache.md index f0b6ad75c..4a08b8add 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_apache.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_apache.md @@ -44,10 +44,12 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb iotdb-jdbc - 1.3.1 + + ${project.version} ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 示例代码 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md b/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md index d1e85f72c..3359b5385 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-JDBC_timecho.md @@ -43,11 +43,13 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb - iotdb-jdbc - 1.3.1 + iotdb-jdbc + + ${project.version} ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 示例代码 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md b/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md index 84571f3ef..dc19f0aa0 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_apache.md @@ -47,6 +47,7 @@ SessionPool 是 Session 的连接池,推荐使用SessionPool编程。在多线 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 创建连接池实例 @@ -72,7 +73,7 @@ public class IoTDBSessionPoolExample { .build(); } } -``` +``` ### 2.3 执行数据库操作 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md b/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md index afe4151ba..db3dcabc1 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Java-Native-API_timecho.md @@ -47,6 +47,7 @@ SessionPool 是 Session 的连接池,推荐使用SessionPool编程。在多线 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 创建连接池实例 @@ -72,7 +73,7 @@ public class IoTDBSessionPoolExample { .build(); } } -``` +``` ### 2.3 执行数据库操作 diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md b/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md index 50a9e07b6..42bab4e64 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_apache.md @@ -29,6 +29,8 @@ 首先下载包:`pip3 install apache-iotdb>=2.0` +注意:请勿使用高版本客户端连接低版本服务。 + 您可以从这里得到一个使用该包进行数据读写的例子:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) 关于对齐时间序列读写的例子:[Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) @@ -49,6 +51,8 @@ session.open(False) zone = session.get_time_zone() session.close() ``` + + ## 3. 基本接口说明 下面将给出 Session 对应的接口的简要介绍和对应参数: diff --git a/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md b/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md index a36c508a0..dffad1211 100644 --- a/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md +++ b/src/zh/UserGuide/Master/Tree/API/Programming-Python-Native-API_timecho.md @@ -29,6 +29,8 @@ 首先下载包:`pip3 install apache-iotdb>=2.0` +注意:请勿使用高版本客户端连接低版本服务。 + 您可以从这里得到一个使用该包进行数据读写的例子:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) 关于对齐时间序列读写的例子:[Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) @@ -49,6 +51,7 @@ session.open(False) zone = session.get_time_zone() session.close() ``` + ## 3. 基本接口说明 下面将给出 Session 对应的接口的简要介绍和对应参数: diff --git a/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md b/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md index b6ec99f11..959bf959a 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_apache.md @@ -41,6 +41,7 @@ IoTDB具备C#原生客户端驱动和对应的连接池,提供对象化接口 ```Plain dotnet add package Apache.IoTDB ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md b/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md index 00f9b5d13..0d1c44c6d 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-CSharp-Native-API_timecho.md @@ -41,6 +41,7 @@ IoTDB具备C#原生客户端驱动和对应的连接池,提供对象化接口 ```Plain dotnet add package Apache.IoTDB ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md b/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md index a5f6a4409..1d37b4f12 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_apache.md @@ -101,10 +101,11 @@ git clone https://github.com/apache/iotdb.git ``` -默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 1.3.2 版本): +默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 2.0.6 版本): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +注意:请勿使用高版本客户端连接低版本服务。 在 IoTDB 根目录下执行 maven 编译: diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md b/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md index 59b5294b5..be499eba7 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Cpp-Native-API_timecho.md @@ -101,10 +101,11 @@ git clone https://github.com/apache/iotdb.git ``` -默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 1.3.2 版本): +默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 2.0.6 版本): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +注意:请勿使用高版本客户端连接低版本服务。 在 IoTDB 根目录下执行 maven 编译: @@ -174,7 +175,7 @@ A: ### 3.1 TableSession 类 -C++ 客户端的操作均通过 TableSession 类进行,下面将给出 TableSession 接口中定义的方法说明。 +C++ 客户端的操作均通过 TableSession 类进行,下面将给出 TableSession 接口中定义的方法说明。 #### 3.1.1 方法列表 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md b/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md index 1b33ff1c1..2892a321a 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_apache.md @@ -82,6 +82,7 @@ go mod tidy # 编译并运行程序 go run session_example.go ``` +* 注意:请勿使用高版本客户端连接低版本服务。 ## 2. ITableSession 接口 ### 2.1 功能描述 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md b/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md index da1533a2e..8866227de 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Go-Native-API_timecho.md @@ -82,6 +82,7 @@ go mod tidy # 编译并运行程序 go run session_example.go ``` +* 注意:请勿使用高版本客户端连接低版本服务。 ## 2. ITableSession 接口 ### 2.1 功能描述 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-JDBC_apache.md b/src/zh/UserGuide/latest-Table/API/Programming-JDBC_apache.md index 96c2bb623..f9ae1e4b7 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-JDBC_apache.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-JDBC_apache.md @@ -47,6 +47,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-JDBC_timecho.md b/src/zh/UserGuide/latest-Table/API/Programming-JDBC_timecho.md index 4bc3ea2bb..9484025d3 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-JDBC_timecho.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-JDBC_timecho.md @@ -47,6 +47,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md index ad3fc1905..d07763cdd 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md @@ -45,6 +45,7 @@ IoTDB具备Java原生客户端驱动和对应的连接池,提供对象化接 ``` * 可从[此处](https://repo1.maven.org/maven2/org/apache/iotdb/iotdb-session/)查看`iotdb-session`最新版本 +* 注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md index bb3134ee6..a17dab3c0 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md @@ -45,6 +45,7 @@ IoTDB具备Java原生客户端驱动和对应的连接池,提供对象化接 ``` * 可从[此处](https://repo1.maven.org/maven2/com/timecho/iotdb/iotdb-session/)查看`iotdb-session`最新版本 +* 注意:请勿使用高版本客户端连接低版本服务。 ## 3. 读写操作 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md b/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md index 63953b310..eaf45591b 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_apache.md @@ -28,6 +28,7 @@ ```shell pip3 install apache-iotdb>=2.0 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 2. 读写操作 @@ -174,7 +175,7 @@ class TableSessionConfig(object): #### 3.1.1 功能描述 -TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 +TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 #### 3.1.2 方法列表 diff --git a/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md b/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md index 2ebecf58e..af1119b53 100644 --- a/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md +++ b/src/zh/UserGuide/latest-Table/API/Programming-Python-Native-API_timecho.md @@ -28,6 +28,7 @@ ```shell pip3 install apache-iotdb>=2.0 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 2. 读写操作 @@ -174,7 +175,7 @@ class TableSessionConfig(object): #### 3.1.1 功能描述 -TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 +TableSessionPool 是一个会话池管理类,用于管理 TableSession 实例的创建和销毁。它提供了从池中获取会话和关闭会话池的功能。 #### 3.1.2 方法列表 diff --git a/src/zh/UserGuide/latest/API/Programming-CSharp-Native-API.md b/src/zh/UserGuide/latest/API/Programming-CSharp-Native-API.md index 40f0b49b3..ed1652786 100644 --- a/src/zh/UserGuide/latest/API/Programming-CSharp-Native-API.md +++ b/src/zh/UserGuide/latest/API/Programming-CSharp-Native-API.md @@ -43,6 +43,7 @@ dotnet add package Apache.IoTDB # 安装0.12.1.2版本的客户端 dotnet add package Apache.IoTDB --version 0.12.1.2 ``` +注意:请勿使用高版本客户端连接低版本服务。 ## 3. 快速入门 diff --git a/src/zh/UserGuide/latest/API/Programming-Cpp-Native-API.md b/src/zh/UserGuide/latest/API/Programming-Cpp-Native-API.md index 25b09db73..ace2fe347 100644 --- a/src/zh/UserGuide/latest/API/Programming-Cpp-Native-API.md +++ b/src/zh/UserGuide/latest/API/Programming-Cpp-Native-API.md @@ -101,10 +101,11 @@ git clone https://github.com/apache/iotdb.git ``` -默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 1.3.2 版本): +默认的主分支是 master 分支,如果你想使用某个发布版本,请切换分支 (如 2.0.6 版本): ```shell -git checkout rc/1.3.2 +git checkout rc/2.0.6 ``` +注意:请勿使用高版本客户端连接低版本服务。 在 IoTDB 根目录下执行 maven 编译: @@ -177,7 +178,7 @@ A: - 开启 Session ```cpp void open(); -``` +``` - 开启 Session,并决定是否开启 RPC 压缩 ```cpp diff --git a/src/zh/UserGuide/latest/API/Programming-Data-Subscription_apache.md b/src/zh/UserGuide/latest/API/Programming-Data-Subscription_apache.md index aa103544a..81695dc8a 100644 --- a/src/zh/UserGuide/latest/API/Programming-Data-Subscription_apache.md +++ b/src/zh/UserGuide/latest/API/Programming-Data-Subscription_apache.md @@ -50,6 +50,7 @@ IoTDB 提供了强大的数据订阅功能,允许用户通过订阅 API 实时 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 代码案例 diff --git a/src/zh/UserGuide/latest/API/Programming-Data-Subscription_timecho.md b/src/zh/UserGuide/latest/API/Programming-Data-Subscription_timecho.md index a927d366c..183fdcc80 100644 --- a/src/zh/UserGuide/latest/API/Programming-Data-Subscription_timecho.md +++ b/src/zh/UserGuide/latest/API/Programming-Data-Subscription_timecho.md @@ -50,6 +50,7 @@ IoTDB 提供了强大的数据订阅功能,允许用户通过订阅 API 实时 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 代码案例 diff --git a/src/zh/UserGuide/latest/API/Programming-Go-Native-API.md b/src/zh/UserGuide/latest/API/Programming-Go-Native-API.md index fe9e49b9b..db85841f9 100644 --- a/src/zh/UserGuide/latest/API/Programming-Go-Native-API.md +++ b/src/zh/UserGuide/latest/API/Programming-Go-Native-API.md @@ -87,6 +87,8 @@ go mod tidy go run session_example.go ``` +* 注意:请勿使用高版本客户端连接低版本服务。 + ## 2. 核心步骤 使用 Go 原生接口操作 IoTDB 的三个核心步骤如下: diff --git a/src/zh/UserGuide/latest/API/Programming-JDBC_apache.md b/src/zh/UserGuide/latest/API/Programming-JDBC_apache.md index f0b6ad75c..4a08b8add 100644 --- a/src/zh/UserGuide/latest/API/Programming-JDBC_apache.md +++ b/src/zh/UserGuide/latest/API/Programming-JDBC_apache.md @@ -44,10 +44,12 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb iotdb-jdbc - 1.3.1 + + ${project.version} ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 示例代码 diff --git a/src/zh/UserGuide/latest/API/Programming-JDBC_timecho.md b/src/zh/UserGuide/latest/API/Programming-JDBC_timecho.md index d1e85f72c..3359b5385 100644 --- a/src/zh/UserGuide/latest/API/Programming-JDBC_timecho.md +++ b/src/zh/UserGuide/latest/API/Programming-JDBC_timecho.md @@ -43,11 +43,13 @@ mvn clean install -pl iotdb-client/jdbc -am -DskipTests org.apache.iotdb - iotdb-jdbc - 1.3.1 + iotdb-jdbc + + ${project.version} ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 示例代码 diff --git a/src/zh/UserGuide/latest/API/Programming-Java-Native-API_apache.md b/src/zh/UserGuide/latest/API/Programming-Java-Native-API_apache.md index 84571f3ef..dc19f0aa0 100644 --- a/src/zh/UserGuide/latest/API/Programming-Java-Native-API_apache.md +++ b/src/zh/UserGuide/latest/API/Programming-Java-Native-API_apache.md @@ -47,6 +47,7 @@ SessionPool 是 Session 的连接池,推荐使用SessionPool编程。在多线 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 创建连接池实例 @@ -72,7 +73,7 @@ public class IoTDBSessionPoolExample { .build(); } } -``` +``` ### 2.3 执行数据库操作 diff --git a/src/zh/UserGuide/latest/API/Programming-Java-Native-API_timecho.md b/src/zh/UserGuide/latest/API/Programming-Java-Native-API_timecho.md index afe4151ba..db3dcabc1 100644 --- a/src/zh/UserGuide/latest/API/Programming-Java-Native-API_timecho.md +++ b/src/zh/UserGuide/latest/API/Programming-Java-Native-API_timecho.md @@ -47,6 +47,7 @@ SessionPool 是 Session 的连接池,推荐使用SessionPool编程。在多线 ``` +注意:请勿使用高版本客户端连接低版本服务。 ### 2.2 创建连接池实例 @@ -72,7 +73,7 @@ public class IoTDBSessionPoolExample { .build(); } } -``` +``` ### 2.3 执行数据库操作 diff --git a/src/zh/UserGuide/latest/API/Programming-Python-Native-API_apache.md b/src/zh/UserGuide/latest/API/Programming-Python-Native-API_apache.md index 50a9e07b6..42bab4e64 100644 --- a/src/zh/UserGuide/latest/API/Programming-Python-Native-API_apache.md +++ b/src/zh/UserGuide/latest/API/Programming-Python-Native-API_apache.md @@ -29,6 +29,8 @@ 首先下载包:`pip3 install apache-iotdb>=2.0` +注意:请勿使用高版本客户端连接低版本服务。 + 您可以从这里得到一个使用该包进行数据读写的例子:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) 关于对齐时间序列读写的例子:[Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) @@ -49,6 +51,8 @@ session.open(False) zone = session.get_time_zone() session.close() ``` + + ## 3. 基本接口说明 下面将给出 Session 对应的接口的简要介绍和对应参数: diff --git a/src/zh/UserGuide/latest/API/Programming-Python-Native-API_timecho.md b/src/zh/UserGuide/latest/API/Programming-Python-Native-API_timecho.md index a36c508a0..dffad1211 100644 --- a/src/zh/UserGuide/latest/API/Programming-Python-Native-API_timecho.md +++ b/src/zh/UserGuide/latest/API/Programming-Python-Native-API_timecho.md @@ -29,6 +29,8 @@ 首先下载包:`pip3 install apache-iotdb>=2.0` +注意:请勿使用高版本客户端连接低版本服务。 + 您可以从这里得到一个使用该包进行数据读写的例子:[Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_example.py) 关于对齐时间序列读写的例子:[Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/rc/2.0.1/iotdb-client/client-py/session_aligned_timeseries_example.py) @@ -49,6 +51,7 @@ session.open(False) zone = session.get_time_zone() session.close() ``` + ## 3. 基本接口说明 下面将给出 Session 对应的接口的简要介绍和对应参数: