-
Notifications
You must be signed in to change notification settings - Fork 5k
docs: update config-file behavior after 3.4.0.0. #34747
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -356,35 +356,17 @@ Directly querying from child table is fast. The query from super table with TAG | |||||
|
|
||||||
| Currently, TDengine only provides compression ratios based on tables, not databases or the entire system. To view the compression ratios, execute the `SHOW TABLE DISTRIBUTED table_name;` command in the client TDengine CLI. The table_name can be a super table, regular table, or subtable. For details, see [SHOW TABLE DISTRIBUTED](https://docs.tdengine.com/tdengine-reference/sql-manual/show-commands/#show-table-distributed). | ||||||
|
|
||||||
| ### 37. Why didn't my configuration parameter take effect even though I modified the configuration file? | ||||||
| ### 37. I modified the configuration file, but the parameters didn't take effect. Why? | ||||||
|
|
||||||
| #### Problem Description | ||||||
|
|
||||||
| In TDengine versions 3.3.5.0 and above, some users might encounter an issue: they modify a configuration parameter in `taos.cfg`, but after restarting, the parameter doesn't seem to take effect, and no errors are found in the logs. | ||||||
| In TDengine TSDB 3.4.0.0 and later, some users may encounter this: they change a parameter in `taos.cfg`, but after restarting, the change does not take effect, and no errors appear in the logs. | ||||||
|
|
||||||
| #### Problem Reason | ||||||
|
|
||||||
| This is because TDengine versions 3.3.5.0 and above support persisting dynamically modified configuration parameters. This means that parameters you change dynamically using the `ALTER` command will remain effective even after a restart. Therefore, when restarting, TDengine versions 3.3.5.0 and above will, by default, load configuration parameters (except for `dataDir` itself) from the `dataDir`, rather than using the parameters configured in `taos.cfg`. | ||||||
| In TDengine TSDB 3.4.0.0 and later, to improve security and prevent configuration file tampering, configuration can no longer be changed by editing the configuration file. Use the `ALTER` command and change parameter values via SQL instead. | ||||||
|
||||||
| In TDengine TSDB 3.4.0.0 and later, to improve security and prevent configuration file tampering, configuration can no longer be changed by editing the configuration file. Use the `ALTER` command and change parameter values via SQL instead. | |
| In TDengine TSDB 3.4.0.0 and later, to improve security and prevent configuration file tampering, most cluster configuration parameters are no longer updated by editing `taos.cfg` after the configuration has been persisted. The configuration file is read on first startup (or when no persisted configuration exists), and some local parameters can still be set there, but subsequent changes to configuration parameters must be made with the `ALTER` command via SQL. |
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -34,7 +34,7 @@ taosd 命令行参数如下: | |||||||||
|
|
||||||||||
| 1. 通过 SQL 修改全局配置参数命令:`alter all dnodes ‘参数名’ ‘参数值’;`,修改后是否立即生效请参考各参数**动态修改**说明。 | ||||||||||
| 2. 通过 SQL 修改局部配置参数命令,`alter dnode <dnode_id> ‘参数名’ ‘参数值’;`,修改后是否立即生效请参考各参数**动态修改**说明。 | ||||||||||
| 3. 自 3.4.0.0 起,为防止配置文件被篡改,我们取消了 `forceReadConfig` 参数;除首次启动外,不再从配置文件中加载配置项。 | ||||||||||
| 3. 自 3.4.0.0 起,为防止配置文件被篡改,我们取消了 `forceReadConfig` 参数;除首次启动外,不再从配置文件中加载配置项,如果需要修改配置参数,请您使用 ALTER 命令,通过 SQL 的方式修改配置参数的值。。 | ||||||||||
|
||||||||||
| 3. 自 3.4.0.0 起,为防止配置文件被篡改,我们取消了 `forceReadConfig` 参数;除首次启动外,不再从配置文件中加载配置项,如果需要修改配置参数,请您使用 ALTER 命令,通过 SQL 的方式修改配置参数的值。。 | |
| 3. 自 3.4.0.0 起,为防止配置文件被篡改,我们取消了 `forceReadConfig` 参数;除首次启动外,不再从配置文件中加载配置项,如果需要修改配置参数,请您使用 ALTER 命令,通过 SQL 的方式修改配置参数的值。 |
Copilot
AI
Mar 11, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
这里写到“除首次启动外,不再从配置文件中加载配置项”,但上面的表格仍写着“局部配置参数…可通过 taos.cfg 配置文件修改”。建议在此处或表格中补充版本/适用场景说明(例如:仅首次启动/无持久化配置时读取 taos.cfg;后续需通过 ALTER 通过 SQL 修改),避免读者误解修改 taos.cfg 重启即可生效。
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There's a typo at the end of this line. The double period 。。 should be a single period 。.
| 3. 自 3.4.0.0 起,为防止配置文件被篡改,我们取消了 `forceReadConfig` 参数;除首次启动外,不再从配置文件中加载配置项,如果需要修改配置参数,请您使用 ALTER 命令,通过 SQL 的方式修改配置参数的值。。 | |
| 3. 自 3.4.0.0 起,为防止配置文件被篡改,我们取消了 `forceReadConfig` 参数;除首次启动外,不再从配置文件中加载配置项,如果需要修改配置参数,请您使用 ALTER 命令,通过 SQL 的方式修改配置参数的值。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This note says taosd won’t load configuration items from
taos.cfgexcept on the first startup, but the table above still states local parameters can be modified viataos.cfg(without any version caveat). Please clarify one/both places so readers understand that editingtaos.cfgonly takes effect on first startup (or when no persisted config exists), and afterwards changes should be done viaALTER.