This is an automated email from the ASF dual-hosted git repository.
haonan 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 fbbe1295 add param auto_adapt to ainode table timecho 2082 (#1000)
fbbe1295 is described below
commit fbbe12950bd4510c502d32e962fb9093e73a1784
Author: leto-b <[email protected]>
AuthorDate: Tue Mar 31 17:08:41 2026 +0800
add param auto_adapt to ainode table timecho 2082 (#1000)
---
.../Table/AI-capability/AINode_Upgrade_timecho.md | 1 +
.../AI-capability/AINode_Upgrade_timecho.md | 1 +
.../Table/AI-capability/AINode_Upgrade_timecho.md | 25 +++++++++++-----------
.../AI-capability/AINode_Upgrade_timecho.md | 1 +
4 files changed, 16 insertions(+), 12 deletions(-)
diff --git a/src/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
b/src/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
index 5467a5af..7e393ff1 100644
--- a/src/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
+++ b/src/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
@@ -98,6 +98,7 @@ SELECT * FROM FORECAST(
| targets | Table parameter | SET SEMANTIC | Input data for the target
variables to be predicted. IoTDB will automatically sort the data in ascending
order of time before passing it to AINode. | Yes | Use SQL to describe the
input data with target variables. If the input SQL is invalid, corresponding
query errors will be reported. |
| history_covs | Scalar parameter | String type (valid table model query SQL),
default: none | Specifies historical data of covariates for this prediction
task, which are used to assist in predicting target variables. AINode will not
output prediction results for historical covariates. Before passing data to the
model, AINode will automatically sort the data in ascending order of time. | No
| 1. Query results can only contain FIELD columns; 2. Other: Different models
may have specific re [...]
| future_covs | Scalar parameter | String type (valid table model query SQL),
default: none | Specifies future data of some covariates for this prediction
task, which are used to assist in predicting target variables. Before passing
data to the model, AINode will automatically sort the data in ascending order
of time. | No | 1. Can only be specified when history_covs is set; 2. The
covariate names involved must be a subset of history_covs; 3. Query results can
only contain FIELD columns; [...]
+| auto_adapt | Scalar parameter | Boolean type, default value: true
| Whether to enable adaptive processing for covariate inference. | No
| When adaptive mode is enabled: 1. If the set of future covariates
(`future_covs`) is not a subset of the historical covariates (`history_covs`),
any future covariates not present in the historical set will be automatically
discarded. 2. If the length of any historical covariate does not match the
length of the input target [...]
| output_start_time | Scalar parameter | Timestamp type. Default value: last
timestamp of target variable + output_interval | Starting timestamp of output
prediction points [i.e., forecast start time] | No | Must be greater than the
maximum timestamp of target variable timestamps |
| output_length | Scalar parameter | INT32 type. Default value: 96 | Output
window size | No | Must be greater than 0 |
| output_interval | Scalar parameter | Time interval type. Default value:
(last timestamp - first timestamp of input data) / n - 1 | Time interval
between output prediction points. Supported units: ns, us, ms, s, m, h, d, w |
No | Must be greater than 0 |
diff --git a/src/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
b/src/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
index 5467a5af..7e393ff1 100644
--- a/src/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
+++ b/src/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
@@ -98,6 +98,7 @@ SELECT * FROM FORECAST(
| targets | Table parameter | SET SEMANTIC | Input data for the target
variables to be predicted. IoTDB will automatically sort the data in ascending
order of time before passing it to AINode. | Yes | Use SQL to describe the
input data with target variables. If the input SQL is invalid, corresponding
query errors will be reported. |
| history_covs | Scalar parameter | String type (valid table model query SQL),
default: none | Specifies historical data of covariates for this prediction
task, which are used to assist in predicting target variables. AINode will not
output prediction results for historical covariates. Before passing data to the
model, AINode will automatically sort the data in ascending order of time. | No
| 1. Query results can only contain FIELD columns; 2. Other: Different models
may have specific re [...]
| future_covs | Scalar parameter | String type (valid table model query SQL),
default: none | Specifies future data of some covariates for this prediction
task, which are used to assist in predicting target variables. Before passing
data to the model, AINode will automatically sort the data in ascending order
of time. | No | 1. Can only be specified when history_covs is set; 2. The
covariate names involved must be a subset of history_covs; 3. Query results can
only contain FIELD columns; [...]
+| auto_adapt | Scalar parameter | Boolean type, default value: true
| Whether to enable adaptive processing for covariate inference. | No
| When adaptive mode is enabled: 1. If the set of future covariates
(`future_covs`) is not a subset of the historical covariates (`history_covs`),
any future covariates not present in the historical set will be automatically
discarded. 2. If the length of any historical covariate does not match the
length of the input target [...]
| output_start_time | Scalar parameter | Timestamp type. Default value: last
timestamp of target variable + output_interval | Starting timestamp of output
prediction points [i.e., forecast start time] | No | Must be greater than the
maximum timestamp of target variable timestamps |
| output_length | Scalar parameter | INT32 type. Default value: 96 | Output
window size | No | Must be greater than 0 |
| output_interval | Scalar parameter | Time interval type. Default value:
(last timestamp - first timestamp of input data) / n - 1 | Time interval
between output prediction points. Supported units: ns, us, ms, s, m, h, d, w |
No | Must be greater than 0 |
diff --git
a/src/zh/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
b/src/zh/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
index 6439e43d..95c9239c 100644
--- a/src/zh/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
+++ b/src/zh/UserGuide/Master/Table/AI-capability/AINode_Upgrade_timecho.md
@@ -92,18 +92,19 @@ SELECT * FROM FORECAST(
* 内置模型推理无需注册流程，通过 forecast 函数，指定 model\_id 就可以使用模型的推理功能。
* 参数介绍
-| 参数名 | 参数类型 | 参数属性
| 描述
| 是否必填 | 备注
|
-|---------------------|-------|----------------------------------------------------|-----------------------------------------------------------------------------------------|
----------
|--------------------------------------------------------------------------------------------------------------------------|
-| model\_id | 标量参数 | 字符串类型
| 预测所用模型的唯一标识
| 是|
|
-| targets | 表参数 | SET SEMANTIC
| 待预测目标变量的输入数据。IoTDB会自动将数据按时间升序排序再交给AINode 。
| 是 | 使用 SQL 描述带预测目标变量的输入数据，输入的 SQL 不合法时会有对应的查询报错。
|
-| history\_covs | 标量参数 | 字符串类型（合法的表模型查询 SQL）默认：无
| 指定此次预测任务的协变量的历史数据，这些数据用于辅助目标变量的预测，AINode 不会对历史协变量输出预测结果。在将数据给予模型前，AINode
会自动将数据按时间升序排序。 | 否 | 1. 查询结果只能包含 FIELD 列； 2.
其它：不同模型可能会有独特要求，不符合时会抛出对应的错误。
|
-| future\_covs | 标量参数 | 字符串类型（合法的表模型查询 SQL） 默认：无
| 指定此次预测任务部分协变量的未来数据，这些数据用于辅助目标变量的预测。 在将数据给予模型前，AINode 会自动将数据按时间升序排序。
| 否 | 1. 当且仅当设置 history\_covs 时可以指定此参数；2. 所涉及协变量名称必须是
history\_covs 的子集； 3. 查询结果只能包含 FIELD 列； 4. 其它：不同模型可能会有独特要求，不符合时会抛出对应的错误。 |
-| output\_start\_time | 标量参数 | 时间戳类型。 默认值：目标变量最后一个时间戳 + output\_interval
| 输出的预测点的起始时间戳 【即起报时间】
| 否 | 必须大于目标变量时间戳的最大值
|
-| output\_length | 标量参数 | INT32 类型。 默认值：96
| 输出窗口大小
| 否 | 必须大于 0
|
-| output\_interval | 标量参数 | 时间间隔类型。 默认值：(输入数据的最后一个时间戳 - 输入数据的第一个时间戳) / n
- 1 | 输出的预测点之间的时间间隔 支持的单位是 ns、us、ms、s、m、h、d、w
| 否 | 必须大于 0
|
-| timecol | 标量参数 | 字符串类型。 默认值：time
| 时间列名
| 否 | 必须为存在于 targets 中的且数据类型为 TIMESTAMP 的列
|
-| preserve\_input | 标量参数 | 布尔类型。 默认值：false
| 是否在输出结果集中保留目标变量输入的所有原始行
| 否 |
|
-| model\_options | 标量参数 | 字符串类型。 默认值：空字符串
| 模型相关的 key-value 对，比如是否需要对输入进行归一化等。不同的 key-value 对以 ';' 间隔
| 否 |
|
+| 参数名 | 参数类型 | 参数属性 | 描述
| 是否必填 |
备注
|
+|---------------------|-------|----------------------------|-----------------------------------------------------------------------------------------|
----------
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| model\_id | 标量参数 | 字符串类型 | 预测所用模型的唯一标识
| 是|
|
+| targets | 表参数 | SET SEMANTIC |
待预测目标变量的输入数据。IoTDB会自动将数据按时间升序排序再交给AINode 。
| 是 | 使用 SQL 描述带预测目标变量的输入数据，输入的 SQL 不合法时会有对应的查询报错。
|
+| history\_covs | 标量参数 | 字符串类型（合法的表模型查询 SQL）默认：无 |
指定此次预测任务的协变量的历史数据，这些数据用于辅助目标变量的预测，AINode 不会对历史协变量输出预测结果。在将数据给予模型前，AINode
会自动将数据按时间升序排序。 | 否 | 1. 查询结果只能包含 FIELD 列； 2.
其它：不同模型可能会有独特要求，不符合时会抛出对应的错误。
|
+| future\_covs | 标量参数 | 字符串类型（合法的表模型查询 SQL） 默认：无 |
指定此次预测任务部分协变量的未来数据，这些数据用于辅助目标变量的预测。 在将数据给予模型前，AINode 会自动将数据按时间升序排序。
| 否 | 1. 当且仅当设置 history\_covs 时可以指定此参数；2. 所涉及协变量名称必须是
history\_covs 的子集； 3. 查询结果只能包含 FIELD 列； 4. 其它：不同模型可能会有独特要求，不符合时会抛出对应的错误。
|
+| auto\_adapt | 标量参数 | 布尔类型，默认值：true | 是否为协变量推理开启自适应。| 否
| 当开启自适应时：1.
若未来协变量集合future\_covs不是历史协变量集合history\_covs的子集，将自动抛弃那些不属于历史协变量的未来协变量。2.
若某个历史协变量的长度不等于输入目标变量的长度：a. 小于时，在其头部补 0；b. 大于时，自动丢弃其最早的数据。3.
若某个未来协变量的长度不等于预测长度output\_length: a. 小于时，在其尾部补 0；b. 大于时，自动丢弃其最新的数据。 |
+| output\_start\_time | 标量参数 | 时间戳类型。 默认值：目标变量最后一个时间戳 + output\_interval
| 输出的预测点的起始时间戳 【即起报时间】
| 否 | 必须大于目标变量时间戳的最大值
|
+| output\_length | 标量参数 | INT32 类型。 默认值：96
| 输出窗口大小
| 否 | 必须大于 0
|
+| output\_interval | 标量参数 | 时间间隔类型。 默认值：(输入数据的最后一个时间戳 - 输入数据的第一个时间戳) / n
- 1 | 输出的预测点之间的时间间隔 支持的单位是 ns、us、ms、s、m、h、d、w
| 否 | 必须大于 0
|
+| timecol | 标量参数 | 字符串类型。 默认值：time
| 时间列名
| 否 | 必须为存在于 targets 中的且数据类型为 TIMESTAMP 的列
|
+| preserve\_input | 标量参数 | 布尔类型。 默认值：false
| 是否在输出结果集中保留目标变量输入的所有原始行
| 否 |
|
+| model\_options | 标量参数 | 字符串类型。 默认值：空字符串
| 模型相关的 key-value 对，比如是否需要对输入进行归一化等。不同的 key-value 对以 ';' 间隔
| 否 |
|
说明：
diff --git
a/src/zh/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
b/src/zh/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
index 60ddbdd3..acd7f50a 100644
--- a/src/zh/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
+++ b/src/zh/UserGuide/latest-Table/AI-capability/AINode_Upgrade_timecho.md
@@ -98,6 +98,7 @@ SELECT * FROM FORECAST(
| targets | 表参数 | SET SEMANTIC
| 待预测目标变量的输入数据。IoTDB会自动将数据按时间升序排序再交给AINode 。
| 是 | 使用 SQL 描述带预测目标变量的输入数据，输入的 SQL 不合法时会有对应的查询报错。
|
| history\_covs | 标量参数 | 字符串类型（合法的表模型查询 SQL）默认：无
| 指定此次预测任务的协变量的历史数据，这些数据用于辅助目标变量的预测，AINode 不会对历史协变量输出预测结果。在将数据给予模型前，AINode
会自动将数据按时间升序排序。 | 否 | 1. 查询结果只能包含 FIELD 列； 2.
其它：不同模型可能会有独特要求，不符合时会抛出对应的错误。
|
| future\_covs | 标量参数 | 字符串类型（合法的表模型查询 SQL） 默认：无
| 指定此次预测任务部分协变量的未来数据，这些数据用于辅助目标变量的预测。 在将数据给予模型前，AINode 会自动将数据按时间升序排序。
| 否 | 1. 当且仅当设置 history\_covs 时可以指定此参数；2. 所涉及协变量名称必须是
history\_covs 的子集； 3. 查询结果只能包含 FIELD 列； 4. 其它：不同模型可能会有独特要求，不符合时会抛出对应的错误。 |
+| auto\_adapt | 标量参数 | 布尔类型，默认值：true | 是否为协变量推理开启自适应。| 否
| 当开启自适应时：1.
若未来协变量集合future\_covs不是历史协变量集合history\_covs的子集，将自动抛弃那些不属于历史协变量的未来协变量。2.
若某个历史协变量的长度不等于输入目标变量的长度：a. 小于时，在其头部补 0；b. 大于时，自动丢弃其最早的数据。3.
若某个未来协变量的长度不等于预测长度output\_length: a. 小于时，在其尾部补 0；b. 大于时，自动丢弃其最新的数据。 |
| output\_start\_time | 标量参数 | 时间戳类型。 默认值：目标变量最后一个时间戳 + output\_interval
| 输出的预测点的起始时间戳 【即起报时间】
| 否 | 必须大于目标变量时间戳的最大值
|
| output\_length | 标量参数 | INT32 类型。 默认值：96
| 输出窗口大小
| 否 | 必须大于 0
|
| output\_interval | 标量参数 | 时间间隔类型。 默认值：(输入数据的最后一个时间戳 - 输入数据的第一个时间戳) / n
- 1 | 输出的预测点之间的时间间隔 支持的单位是 ns、us、ms、s、m、h、d、w
| 否 | 必须大于 0
|
