This is an automated email from the ASF dual-hosted git repository.
jackietien pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git
The following commit(s) were added to refs/heads/main by this push:
new 292b944 [IOTDB-6086] Add doc about session interface of faster last
query in one device
292b944 is described below
commit 292b944d3c1f2ce8a8ae90f5e24816a6b70f3413
Author: Weihao Li <[email protected]>
AuthorDate: Thu Jul 27 21:06:03 2023 +0800
[IOTDB-6086] Add doc about session interface of faster last query in one
device
---
src/UserGuide/Master/API/Programming-Java-Native-API.md | 13 +++++++++----
src/UserGuide/V1.2.x/API/Programming-Java-Native-API.md | 13 +++++++++----
src/zh/UserGuide/Master/API/Programming-Java-Native-API.md | 12 ++++++++----
src/zh/UserGuide/V1.2.x/API/Programming-Java-Native-API.md | 12 ++++++++----
4 files changed, 34 insertions(+), 16 deletions(-)
diff --git a/src/UserGuide/Master/API/Programming-Java-Native-API.md
b/src/UserGuide/Master/API/Programming-Java-Native-API.md
index 6108f70..1bef987 100644
--- a/src/UserGuide/Master/API/Programming-Java-Native-API.md
+++ b/src/UserGuide/Master/API/Programming-Java-Native-API.md
@@ -394,10 +394,15 @@ SessionDataSet executeRawDataQuery(List<String> paths,
long startTime, long endT
* Last query:
- Query the last data, whose timestamp is greater than or equal LastTime.
-
-``` java
-SessionDataSet executeLastDataQuery(List<String> paths, long LastTime);
-```
+ ``` java
+ SessionDataSet executeLastDataQuery(List<String> paths, long LastTime);
+ ```
+ - Query the latest point of the specified series of single device quickly,
and support redirection;
+ If you are sure that the query path is valid, set 'isLegalPathNodes' to
true to avoid performance penalties from path verification.
+ ``` java
+ SessionDataSet executeLastDataQueryForOneDevice(
+ String db, String device, List<String> sensors, boolean
isLegalPathNodes);
+ ```
* Aggregation query:
- Support specified query time range: The specified query time range is a
left-closed right-open interval, including the start time but not the end time.
diff --git a/src/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
b/src/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
index 59f9889..0a288c0 100644
--- a/src/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
+++ b/src/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
@@ -394,10 +394,15 @@ SessionDataSet executeRawDataQuery(List<String> paths,
long startTime, long endT
* Last query:
- Query the last data, whose timestamp is greater than or equal LastTime.
-
-``` java
-SessionDataSet executeLastDataQuery(List<String> paths, long LastTime);
-```
+ ``` java
+ SessionDataSet executeLastDataQuery(List<String> paths, long LastTime);
+ ```
+ - Query the latest point of the specified series of single device quickly,
and support redirection;
+ If you are sure that the query path is valid, set 'isLegalPathNodes' to true
to avoid performance penalties from path verification.
+ ``` java
+ SessionDataSet executeLastDataQueryForOneDevice(
+ String db, String device, List<String> sensors, boolean
isLegalPathNodes);
+ ```
* Aggregation query:
- Support specified query time range: The specified query time range is a
left-closed right-open interval, including the start time but not the end time.
diff --git a/src/zh/UserGuide/Master/API/Programming-Java-Native-API.md
b/src/zh/UserGuide/Master/API/Programming-Java-Native-API.md
index 967659f..2aba610 100644
--- a/src/zh/UserGuide/Master/API/Programming-Java-Native-API.md
+++ b/src/zh/UserGuide/Master/API/Programming-Java-Native-API.md
@@ -393,10 +393,14 @@ SessionDataSet executeRawDataQuery(List<String> paths,
long startTime, long endT
* 最新点查询：
- 查询最后一条时间戳大于等于某个时间点的数据。
-
-``` java
-SessionDataSet executeLastDataQuery(List<String> paths, long lastTime);
-```
+ ``` java
+ SessionDataSet executeLastDataQuery(List<String> paths, long lastTime);
+ ```
+ -
快速查询单设备下指定序列最新点，支持重定向；如果您确认使用的查询路径是合法的，可将`isLegalPathNodes`置为true以避免路径校验带来的性能损失。
+ ``` java
+ SessionDataSet executeLastDataQueryForOneDevice(
+ String db, String device, List<String> sensors, boolean
isLegalPathNodes);
+ ```
* 聚合查询：
- 支持指定查询时间范围。指定的查询时间范围为左闭右开区间，包含开始时间但不包含结束时间。
diff --git a/src/zh/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
b/src/zh/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
index e346959..698dca1 100644
--- a/src/zh/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
+++ b/src/zh/UserGuide/V1.2.x/API/Programming-Java-Native-API.md
@@ -393,10 +393,14 @@ SessionDataSet executeRawDataQuery(List<String> paths,
long startTime, long endT
* 最新点查询：
- 查询最后一条时间戳大于等于某个时间点的数据。
-
-``` java
-SessionDataSet executeLastDataQuery(List<String> paths, long lastTime);
-```
+ ``` java
+ SessionDataSet executeLastDataQuery(List<String> paths, long lastTime);
+ ```
+ -
快速查询单设备下指定序列最新点，支持重定向；如果您确认使用的查询路径是合法的，可将`isLegalPathNodes`置为true以避免路径校验带来的性能损失。
+ ``` java
+ SessionDataSet executeLastDataQueryForOneDevice(
+ String db, String device, List<String> sensors, boolean
isLegalPathNodes);
+ ```
* 聚合查询：
- 支持指定查询时间范围。指定的查询时间范围为左闭右开区间，包含开始时间但不包含结束时间。
