This is an automated email from the ASF dual-hosted git repository.
critas 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 6c9d134b add cache_last_values_memory_budget_in_byte and related
params (#938)
6c9d134b is described below
commit 6c9d134b0d709bb5dfc22c75237a58c0da9cf0c3
Author: leto-b <[email protected]>
AuthorDate: Fri Dec 26 11:13:51 2025 +0800
add cache_last_values_memory_budget_in_byte and related params (#938)
---
.../Master/Table/Reference/System-Config-Manual.md | 29 ++++++++++++++++++++
.../Master/Tree/Reference/Common-Config-Manual.md | 31 +++++++++++++++++++++-
.../latest-Table/Reference/System-Config-Manual.md | 28 +++++++++++++++++++
.../latest/Reference/Common-Config-Manual.md | 31 +++++++++++++++++++++-
.../Master/Table/Reference/System-Config-Manual.md | 29 ++++++++++++++++++++
.../Master/Tree/Reference/Common-Config-Manual.md | 31 +++++++++++++++++++++-
.../latest-Table/Reference/System-Config-Manual.md | 29 ++++++++++++++++++++
.../latest/Reference/Common-Config-Manual.md | 30 ++++++++++++++++++++-
8 files changed, 234 insertions(+), 4 deletions(-)
diff --git a/src/UserGuide/Master/Table/Reference/System-Config-Manual.md
b/src/UserGuide/Master/Table/Reference/System-Config-Manual.md
index 0bc1ea5e..8aec7d62 100644
--- a/src/UserGuide/Master/Table/Reference/System-Config-Manual.md
+++ b/src/UserGuide/Master/Table/Reference/System-Config-Manual.md
@@ -3251,6 +3251,35 @@ The `iotdb-system.properties` file contains various
configurations for managing
| Default | 5 |
| Effective | Restart required. |
+
+* last_cache_operation_on_load
+
+|Name| last_cache_operation_on_load
|
+|:---:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| The operation performed to LastCache when a TsFile is
successfully loaded. `UPDATE`: use the data in the TsFile to update LastCache;
`UPDATE_NO_BLOB`: similar to UPDATE, but will invalidate LastCache for blob
series; `CLEAN_DEVICE`: invalidate LastCache of devices contained in the
TsFile; `CLEAN_ALL`: clean the whole LastCache. |
+|Type| String
|
+|Default| UPDATE_NO_BLOB
|
+|Effective| Effective after restart
|
+
+* cache_last_values_for_load
+
+|Name| cache_last_values_for_load
|
+|:---:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| Whether to cache last values before loading a TsFile. Only
effective when `last_cache_operation_on_load=UPDATE_NO_BLOB` or
`last_cache_operation_on_load=UPDATE`. When set to true, blob series will be
ignored even with `last_cache_operation_on_load=UPDATE`. Enabling this will
increase the memory footprint during loading TsFiles. |
+|Type| Boolean
|
+|Default| true
|
+|Effective| Effective after restart
|
+
+* cache_last_values_memory_budget_in_byte
+
+|Name| cache_last_values_memory_budget_in_byte
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| When `cache_last_values_for_load=true`, the maximum memory that
can be used to cache last values. If this value is exceeded, the cached values
will be abandoned and last values will be read from the TsFile in a streaming
manner. |
+|Type| int32
|
+|Default| 4194304
|
+|Effective| Effective after restart
|
+
+
### 4.38 Dispatch Retry Configuration
- enable_retry_for_unknown_error
diff --git a/src/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
b/src/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
index aa875cc0..78102c9b 100644
--- a/src/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
+++ b/src/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
@@ -2210,4 +2210,33 @@ Different configuration parameters take effect in the
following three ways:
|Description| Active listening polling interval in seconds. The function of
actively listening to tsfile is achieved by polling the folder. This
configuration specifies the time interval between two checks of
load_active_listening_dirs, and the next check will be executed after
load_active_listening_check_interval_seconds seconds of each check. When the
user sets the polling interval to less than 1, it will be set to the default
value of 5 seconds. |
|Type| Long |
|Default| 5|
-|Effective|Effective after restart|
\ No newline at end of file
+|Effective|Effective after restart|
+
+
+* last\_cache\_operation\_on\_load
+
+|Name| last\_cache\_operation\_on\_load
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| The operation performed to LastCache when a TsFile is
successfully loaded. `UPDATE`: use the data in the TsFile to update LastCache;
`UPDATE_NO_BLOB`: similar to UPDATE, but will invalidate LastCache for blob
series; `CLEAN_DEVICE`: invalidate LastCache of devices contained in the
TsFile; `CLEAN_ALL`: clean the whole LastCache. |
+|Type| String
|
+|Default| UPDATE_NO_BLOB
|
+|Effective| Effective after restart
|
+
+* cache\_last\_values\_for\_load
+
+|Name| cache\_last\_values\_for\_load
|
+|:---:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| Whether to cache last values before loading a TsFile. Only
effective when `last_cache_operation_on_load=UPDATE_NO_BLOB` or
`last_cache_operation_on_load=UPDATE`. When set to true, blob series will be
ignored even with `last_cache_operation_on_load=UPDATE`. Enabling this will
increase the memory footprint during loading TsFiles. |
+|Type| Boolean
|
+|Default| true
|
+|Effective| Effective after restart
|
+
+* cache\_last\_values\_memory\_budget\_in\_byte
+
+|Name| cache\_last\_values\_memory\_budget\_in\_byte
|
+|:---:|:----------------------------------------------------------------------------------------------------|
+|Description| When `cache_last_values_for_load=true`, the maximum memory that
can be used to cache last values. If this value is exceeded, the cached values
will be abandoned and last values will be read from the TsFile in a streaming
manner. |
+|Type| int32
|
+|Default| 4194304
|
+|Effective| Effective after restart
|
+
diff --git a/src/UserGuide/latest-Table/Reference/System-Config-Manual.md
b/src/UserGuide/latest-Table/Reference/System-Config-Manual.md
index 0bc1ea5e..99d775f8 100644
--- a/src/UserGuide/latest-Table/Reference/System-Config-Manual.md
+++ b/src/UserGuide/latest-Table/Reference/System-Config-Manual.md
@@ -3251,6 +3251,34 @@ The `iotdb-system.properties` file contains various
configurations for managing
| Default | 5 |
| Effective | Restart required. |
+* last_cache_operation_on_load
+
+|Name| last_cache_operation_on_load
|
+|:---:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| The operation performed to LastCache when a TsFile is
successfully loaded. `UPDATE`: use the data in the TsFile to update LastCache;
`UPDATE_NO_BLOB`: similar to UPDATE, but will invalidate LastCache for blob
series; `CLEAN_DEVICE`: invalidate LastCache of devices contained in the
TsFile; `CLEAN_ALL`: clean the whole LastCache. |
+|Type| String
|
+|Default| UPDATE_NO_BLOB
|
+|Effective| Effective after restart
|
+
+* cache_last_values_for_load
+
+|Name| cache_last_values_for_load
|
+|:---:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| Whether to cache last values before loading a TsFile. Only
effective when `last_cache_operation_on_load=UPDATE_NO_BLOB` or
`last_cache_operation_on_load=UPDATE`. When set to true, blob series will be
ignored even with `last_cache_operation_on_load=UPDATE`. Enabling this will
increase the memory footprint during loading TsFiles. |
+|Type| Boolean
|
+|Default| true
|
+|Effective| Effective after restart
|
+
+* cache_last_values_memory_budget_in_byte
+
+|Name| cache_last_values_memory_budget_in_byte
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| When `cache_last_values_for_load=true`, the maximum memory that
can be used to cache last values. If this value is exceeded, the cached values
will be abandoned and last values will be read from the TsFile in a streaming
manner. |
+|Type| int32
|
+|Default| 4194304
|
+|Effective| Effective after restart
|
+
+
### 4.38 Dispatch Retry Configuration
- enable_retry_for_unknown_error
diff --git a/src/UserGuide/latest/Reference/Common-Config-Manual.md
b/src/UserGuide/latest/Reference/Common-Config-Manual.md
index 59f08c23..e81ba85c 100644
--- a/src/UserGuide/latest/Reference/Common-Config-Manual.md
+++ b/src/UserGuide/latest/Reference/Common-Config-Manual.md
@@ -2210,4 +2210,33 @@ Different configuration parameters take effect in the
following three ways:
|Description| Active listening polling interval in seconds. The function of
actively listening to tsfile is achieved by polling the folder. This
configuration specifies the time interval between two checks of
load_active_listening_dirs, and the next check will be executed after
load_active_listening_check_interval_seconds seconds of each check. When the
user sets the polling interval to less than 1, it will be set to the default
value of 5 seconds. |
|Type| Long |
|Default| 5|
-|Effective|Effective after restart|
\ No newline at end of file
+|Effective|Effective after restart|
+
+
+* last\_cache\_operation\_on\_load
+
+|Name| last\_cache\_operation\_on\_load
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| The operation performed to LastCache when a TsFile is
successfully loaded. `UPDATE`: use the data in the TsFile to update LastCache;
`UPDATE_NO_BLOB`: similar to UPDATE, but will invalidate LastCache for blob
series; `CLEAN_DEVICE`: invalidate LastCache of devices contained in the
TsFile; `CLEAN_ALL`: clean the whole LastCache. |
+|Type| String
|
+|Default| UPDATE_NO_BLOB
|
+|Effective| Effective after restart
|
+
+* cache\_last\_values\_for\_load
+
+|Name| cache\_last\_values\_for\_load
|
+|:---:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Description| Whether to cache last values before loading a TsFile. Only
effective when `last_cache_operation_on_load=UPDATE_NO_BLOB` or
`last_cache_operation_on_load=UPDATE`. When set to true, blob series will be
ignored even with `last_cache_operation_on_load=UPDATE`. Enabling this will
increase the memory footprint during loading TsFiles. |
+|Type| Boolean
|
+|Default| true
|
+|Effective| Effective after restart
|
+
+* cache\_last\_values\_memory\_budget\_in\_byte
+
+|Name| cache\_last\_values\_memory\_budget\_in\_byte
|
+|:---:|:----------------------------------------------------------------------------------------------------|
+|Description| When `cache_last_values_for_load=true`, the maximum memory that
can be used to cache last values. If this value is exceeded, the cached values
will be abandoned and last values will be read from the TsFile in a streaming
manner. |
+|Type| int32
|
+|Default| 4194304
|
+|Effective| Effective after restart
|
+
diff --git a/src/zh/UserGuide/Master/Table/Reference/System-Config-Manual.md
b/src/zh/UserGuide/Master/Table/Reference/System-Config-Manual.md
index a8dd20dd..936467cf 100644
--- a/src/zh/UserGuide/Master/Table/Reference/System-Config-Manual.md
+++ b/src/zh/UserGuide/Master/Table/Reference/System-Config-Manual.md
@@ -3230,6 +3230,35 @@ IoTDB 配置文件位于 IoTDB 安装目录：`conf`文件夹下。
| 默认值 | 5 |
| 改后生效方式 | 重启服务生效 |
+
+* last_cache_operation_on_load
+
+|名字| last_cache_operation_on_load
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 当成功加载一个 TsFile 时，对 LastCache 执行的操作。`UPDATE`：使用 TsFile 中的数据更新
LastCache；`UPDATE_NO_BLOB`：与 UPDATE 类似，但会使 blob 序列的 LastCache
失效；`CLEAN_DEVICE`：使 TsFile 中包含的设备的 LastCache 失效；`CLEAN_ALL`：清空整个 LastCache。 |
+|类型| String
|
+|默认值| UPDATE_NO_BLOB
|
+|改后生效方式| 重启后生效
|
+
+* cache_last_values_for_load
+
+|名字| cache_last_values_for_load
|
+|:---:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 在加载 TsFile 之前是否缓存最新值（last values）。仅在
`last_cache_operation_on_load=UPDATE_NO_BLOB` 或
`last_cache_operation_on_load=UPDATE` 时生效。当设置为 true 时，即使
`last_cache_operation_on_load=UPDATE`，也会忽略 blob 序列。启用此选项会在加载 TsFile 期间增加内存占用。 |
+|类型| Boolean
|
+|默认值| true
|
+|改后生效方式| 重启后生效
|
+
+* cache_last_values_memory_budget_in_byte
+
+|名字| cache_last_values_memory_budget_in_byte
|
+|:---:|:----------------------------------------------------------------------------------------------------|
+|描述| 当 `cache_last_values_for_load=true`
时，用于缓存最新值的最大内存大小（以字节为单位）。如果超过该值，缓存的值将被丢弃，并以流式方式直接从 TsFile 中读取最新值。 |
+|类型| int32
|
+|默认值| 4194304
|
+|改后生效方式| 重启后生效
|
+
+
### 3.38 分发重试配置
- enable_retry_for_unknown_error
diff --git a/src/zh/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
b/src/zh/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
index c7c82136..2829be0c 100644
--- a/src/zh/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
+++ b/src/zh/UserGuide/Master/Tree/Reference/Common-Config-Manual.md
@@ -2217,4 +2217,33 @@ IoTDB ConfigNode 和 DataNode 的公共配置参数位于 `conf` 目录下。
|描述| 主动监听轮询间隔，单位秒。主动监听 tsfile 的功能是通过轮询检查文件夹实现的。该配置指定了两次检查
load_active_listening_dirs 的时间间隔，每次检查完成
load_active_listening_check_interval_seconds 秒后，会执行下一次检查。当用户设置的轮询间隔小于 1
时，会被设置为默认值 5 秒。 |
|类型| Long |
|默认值| 5|
-|改后生效方式|重启后生效|
\ No newline at end of file
+|改后生效方式|重启后生效|
+
+
+* last\_cache\_operation\_on\_load
+
+|名字| last\_cache\_operation\_on\_load
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 当成功加载一个 TsFile 时，对 LastCache 执行的操作。`UPDATE`：使用 TsFile 中的数据更新
LastCache；`UPDATE_NO_BLOB`：与 UPDATE 类似，但会使 blob 序列的 LastCache
失效；`CLEAN_DEVICE`：使 TsFile 中包含的设备的 LastCache 失效；`CLEAN_ALL`：清空整个 LastCache。 |
+|类型| String
|
+|默认值| UPDATE_NO_BLOB
|
+|改后生效方式| 重启后生效
|
+
+* cache\_last\_values\_for\_load
+
+|名字| cache\_last\_values\_for\_load
|
+|:---:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 在加载 TsFile 之前是否缓存最新值（last values）。仅在
`last_cache_operation_on_load=UPDATE_NO_BLOB` 或
`last_cache_operation_on_load=UPDATE` 时生效。当设置为 true 时，即使
`last_cache_operation_on_load=UPDATE`，也会忽略 blob 序列。启用此选项会在加载 TsFile 期间增加内存占用。 |
+|类型| Boolean
|
+|默认值| true
|
+|改后生效方式| 重启后生效
|
+
+* cache\_last\_values\_memory\_budget\_in\_byte
+
+|名字| cache\_last\_values\_memory\_budget\_in\_byte
|
+|:---:|:----------------------------------------------------------------------------------------------------|
+|描述| 当 `cache_last_values_for_load=true`
时，用于缓存最新值的最大内存大小（以字节为单位）。如果超过该值，缓存的值将被丢弃，并以流式方式直接从 TsFile 中读取最新值。 |
+|类型| int32
|
+|默认值| 4194304
|
+|改后生效方式| 重启后生效
|
+
diff --git a/src/zh/UserGuide/latest-Table/Reference/System-Config-Manual.md
b/src/zh/UserGuide/latest-Table/Reference/System-Config-Manual.md
index 7d920f27..3b1a6843 100644
--- a/src/zh/UserGuide/latest-Table/Reference/System-Config-Manual.md
+++ b/src/zh/UserGuide/latest-Table/Reference/System-Config-Manual.md
@@ -3230,6 +3230,35 @@ IoTDB 配置文件位于 IoTDB 安装目录：`conf`文件夹下。
| 默认值 | 5 |
| 改后生效方式 | 重启服务生效 |
+
+* last_cache_operation_on_load
+
+|名字| last_cache_operation_on_load
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 当成功加载一个 TsFile 时，对 LastCache 执行的操作。`UPDATE`：使用 TsFile 中的数据更新
LastCache；`UPDATE_NO_BLOB`：与 UPDATE 类似，但会使 blob 序列的 LastCache
失效；`CLEAN_DEVICE`：使 TsFile 中包含的设备的 LastCache 失效；`CLEAN_ALL`：清空整个 LastCache。 |
+|类型| String
|
+|默认值| UPDATE_NO_BLOB
|
+|改后生效方式| 重启后生效
|
+
+* cache_last_values_for_load
+
+|名字| cache_last_values_for_load
|
+|:---:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 在加载 TsFile 之前是否缓存最新值（last values）。仅在
`last_cache_operation_on_load=UPDATE_NO_BLOB` 或
`last_cache_operation_on_load=UPDATE` 时生效。当设置为 true 时，即使
`last_cache_operation_on_load=UPDATE`，也会忽略 blob 序列。启用此选项会在加载 TsFile 期间增加内存占用。 |
+|类型| Boolean
|
+|默认值| true
|
+|改后生效方式| 重启后生效
|
+
+* cache_last_values_memory_budget_in_byte
+
+|名字| cache_last_values_memory_budget_in_byte
|
+|:---:|:----------------------------------------------------------------------------------------------------|
+|描述| 当 `cache_last_values_for_load=true`
时，用于缓存最新值的最大内存大小（以字节为单位）。如果超过该值，缓存的值将被丢弃，并以流式方式直接从 TsFile 中读取最新值。 |
+|类型| int32
|
+|默认值| 4194304
|
+|改后生效方式| 重启后生效
|
+
+
### 3.38 分发重试配置
- enable_retry_for_unknown_error
diff --git a/src/zh/UserGuide/latest/Reference/Common-Config-Manual.md
b/src/zh/UserGuide/latest/Reference/Common-Config-Manual.md
index c7c82136..235e27a4 100644
--- a/src/zh/UserGuide/latest/Reference/Common-Config-Manual.md
+++ b/src/zh/UserGuide/latest/Reference/Common-Config-Manual.md
@@ -2217,4 +2217,32 @@ IoTDB ConfigNode 和 DataNode 的公共配置参数位于 `conf` 目录下。
|描述| 主动监听轮询间隔，单位秒。主动监听 tsfile 的功能是通过轮询检查文件夹实现的。该配置指定了两次检查
load_active_listening_dirs 的时间间隔，每次检查完成
load_active_listening_check_interval_seconds 秒后，会执行下一次检查。当用户设置的轮询间隔小于 1
时，会被设置为默认值 5 秒。 |
|类型| Long |
|默认值| 5|
-|改后生效方式|重启后生效|
\ No newline at end of file
+|改后生效方式|重启后生效|
+
+* last\_cache\_operation\_on\_load
+
+|名字| last\_cache\_operation\_on\_load
|
+|:---:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 当成功加载一个 TsFile 时，对 LastCache 执行的操作。`UPDATE`：使用 TsFile 中的数据更新
LastCache；`UPDATE_NO_BLOB`：与 UPDATE 类似，但会使 blob 序列的 LastCache
失效；`CLEAN_DEVICE`：使 TsFile 中包含的设备的 LastCache 失效；`CLEAN_ALL`：清空整个 LastCache。 |
+|类型| String
|
+|默认值| UPDATE_NO_BLOB
|
+|改后生效方式| 重启后生效
|
+
+* cache\_last\_values\_for\_load
+
+|名字| cache\_last\_values\_for\_load
|
+|:---:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|描述| 在加载 TsFile 之前是否缓存最新值（last values）。仅在
`last_cache_operation_on_load=UPDATE_NO_BLOB` 或
`last_cache_operation_on_load=UPDATE` 时生效。当设置为 true 时，即使
`last_cache_operation_on_load=UPDATE`，也会忽略 blob 序列。启用此选项会在加载 TsFile 期间增加内存占用。 |
+|类型| Boolean
|
+|默认值| true
|
+|改后生效方式| 重启后生效
|
+
+* cache\_last\_values\_memory\_budget\_in\_byte
+
+|名字| cache\_last\_values\_memory\_budget\_in\_byte
|
+|:---:|:----------------------------------------------------------------------------------------------------|
+|描述| 当 `cache_last_values_for_load=true`
时，用于缓存最新值的最大内存大小（以字节为单位）。如果超过该值，缓存的值将被丢弃，并以流式方式直接从 TsFile 中读取最新值。 |
+|类型| int32
|
+|默认值| 4194304
|
+|改后生效方式| 重启后生效
|
+
