diff --git a/src/UserGuide/Master/Table/Reference/System-Config-Manual.md b/src/UserGuide/Master/Table/Reference/System-Config-Manual.md index 0bc1ea5e6..8aec7d62a 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 e8ca5ced0..49a633968 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 0bc1ea5e6..99d775f88 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 68e8eef0d..c4c655be6 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 a8dd20dd3..936467cf3 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 3ebffd6ac..fe7147021 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 7d920f27d..3b1a6843f 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 3ebffd6ac..783007431 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 | +|改后生效方式| 重启后生效 | +