Merge branch '3.0' of https://github.com/taosdata/TDengine into enh/-TD-31890-15

docs/zh/03-intro.md

@@ -14,9 +14,9 @@ TDengine 是一个高性能、分布式的时序数据库。通过集成的缓
 
 TDengine OSS 是一个开源的高性能时序数据库，与其他时序数据库相比，它的核心优势在于其集群开源、高性能和云原生架构。而且除了基础的写入、查询和存储功能外，TDengine OSS 还集成了缓存、流式计算和数据订阅等高级功能，这些功能显著简化了系统设计，降低了企业的研发和运营成本。
 
-在 TDengine OSS 的基础上，企业版 TDengine Enterprise 提供了增强的辅助功能，包括数据的备份恢复、异地容灾、多级存储、视图、权限控制、安全加密、IP 白名单、支持 MQTT、OPC-UA、OPC-DA、PI、Wonderware、Kafka 等各种数据源。这些功能为企业提供了更为全面、安全、可靠和高效的时序数据管理解决方案。
+在 TDengine OSS 的基础上，企业版 TDengine Enterprise 提供了增强的辅助功能，包括数据的备份恢复、异地容灾、多级存储、视图、权限控制、安全加密、IP 白名单、支持 MQTT、OPC-UA、OPC-DA、PI、Wonderware、Kafka 等各种数据源。这些功能为企业提供了更为全面、安全、可靠和高效的时序数据管理解决方案。更多的细节请看 [TDengine Enterprise](https://www.taosdata.com/tdengine-pro)
 
-此外，TDengine Cloud 作为一种全托管的云服务，存储与计算分离，分开计费，为企业提供了企业级的工具和服务，彻底解决了运维难题，尤其适合中小规模的用户使用。
+此外，TDengine Cloud 作为一种全托管的云服务，存储与计算分离，分开计费，为企业提供了企业级的工具和服务，彻底解决了运维难题，尤其适合中小规模的用户使用。更多的细节请看[TDengine 云服务](https://cloud.taosdata.com/?utm_source=menu&utm_medium=webcn)
 
 ## TDengine 主要功能与特性
 
@@ -135,9 +135,3 @@ TDengine 经过特别优化，以适应时间序列数据的独特需求，引
 - [TDengine 与 InfluxDB、OpenTSDB、Cassandra、MySQL、ClickHouse 等数据库的对比测试报告](https://www.taosdata.com/downloads/TDengine_Testing_Report_cn.pdf)
 
 
-## 主要产品
-
-TDengine 有两个主要产品：TDengine Enterprise （即 TDengine 企业版）和 TDengine Cloud，关于它们的具体定义请参考 
-- [TDengine 企业版](https://www.taosdata.com/tdengine-pro)
-- [TDengine 云服务](https://cloud.taosdata.com/?utm_source=menu&utm_medium=webcn)
-

docs/zh/04-get-started/01-docker.md

@@ -90,7 +90,7 @@ taosBenchmark 提供了丰富的选项，允许用户自定义测试参数，如
 taosBenchmark --help
 ```
 
-有关taosBenchmark 的详细使用方法，请参考[taosBenchmark 参考手册](../../reference/components/taosbenchmark)
+有关taosBenchmark 的详细使用方法，请参考[taosBenchmark 参考手册](../../reference/tools/taosbenchmark)
 
 ### 体验查询
 

docs/zh/04-get-started/03-package.md

@@ -263,7 +263,7 @@ SELECT * FROM t;
 Query OK, 2 row(s) in set (0.003128s)
 ```
 
-除执行 SQL 语句外，系统管理员还可以从 TDengine CLI 进行检查系统运行状态、添加删除用户账号等操作。TDengine CLI 连同应用驱动也可以独立安装在机器上运行，更多细节请参考 [TDengine 命令行](../../reference/components/taos-cli/)。
+除执行 SQL 语句外，系统管理员还可以从 TDengine CLI 进行检查系统运行状态、添加删除用户账号等操作。TDengine CLI 连同应用驱动也可以独立安装在机器上运行，更多细节请参考 [TDengine 命令行](../../reference/tools/taos-cli/)。
 
 ## 快速体验
 
@@ -286,7 +286,7 @@ taosBenchmark 提供了丰富的选项，允许用户自定义测试参数，如
 taosBenchmark --help
 ```
 
-有关taosBenchmark 的详细使用方法，请参考[taosBenchmark 参考手册](../../reference/components/taosbenchmark)
+有关taosBenchmark 的详细使用方法，请参考[taosBenchmark 参考手册](../../reference/tools/taosbenchmark)
 
 ### 体验查询
 

docs/zh/10-third-party/07-tool/index.md

@@ -1,6 +1,6 @@
 ---
-sidebar_label: 管理开发
-title: 与各种管理开发工具的集成
+sidebar_label: 数据库管理
+title: 与各种数据库管理开发工具的集成
 toc_max_heading_level: 4
 ---
 

docs/zh/14-reference/01-components/08-taos-cli.md

@@ -1,102 +0,0 @@
----
-title: TDengine CLI 参考手册
-sidebar_label: taos
-toc_max_heading_level: 4
----
-
-TDengine 命令行程序（以下简称 TDengine CLI）是用户操作 TDengine 实例并与之交互的最简洁最常用的方式。 使用前需要安装 TDengine Server 安装包或 TDengine Client 安装包。
-
-## 启动
-
-要进入 TDengine CLI，您只要在终端执行 `taos` 即可。
-
-```bash
-taos
-```
-
-如果连接服务成功，将会打印出欢迎消息和版本信息。如果失败，则会打印错误消息。
-
-TDengine CLI 的提示符号如下：
-
-```shell
-taos>
-```
-
-进入 TDengine CLI 后，你可执行各种 SQL 语句，包括插入、查询以及各种管理命令。
-
-## 执行 SQL 脚本
-
-在 TDengine CLI 里可以通过 `source` 命令来运行脚本文件中的多条 SQL 命令。
-
-```sql
-taos> source <filename>;
-```
-
-## 在线修改显示字符宽度
-
-可以在 TDengine CLI 里使用如下命令调整字符显示宽度
-
-```sql
-taos> SET MAX_BINARY_DISPLAY_WIDTH <nn>;
-```
-
-如显示的内容后面以 ... 结尾时，表示该内容已被截断，可通过本命令修改显示字符宽度以显示完整的内容。
-
-## 命令行参数
-
-您可通过配置命令行参数来改变 TDengine CLI 的行为。以下为常用的几个命令行参数：
-
-- -h HOST: 要连接的 TDengine 服务端所在服务器的 FQDN, 默认为连接本地服务
-- -P PORT: 指定服务端所用端口号
-- -u USER: 连接时使用的用户名
-- -p PASSWORD: 连接服务端时使用的密码
-- -?, --help: 打印出所有命令行参数
-
-还有更多其他参数：
-
-- -a AUTHSTR: 连接服务端的授权信息
-- -A: 通过用户名和密码计算授权信息
-- -B: 设置 BI 工具显示模式，设置后所有输出都遵循 BI 工具的格式进行输出
-- -c CONFIGDIR: 指定配置文件目录，Linux 环境下默认为 `/etc/taos`，该目录下的配置文件默认名称为 `taos.cfg`
-- -C: 打印 -c 指定的目录中 `taos.cfg` 的配置参数
-- -d DATABASE: 指定连接到服务端时使用的数据库
-- -E dsn: 使用 WebSocket DSN 连接云服务或者提供 WebSocket 连接的服务端
-- -f FILE: 以非交互模式执行 SQL 脚本文件。文件中一个 SQL 语句只能占一行
-- -k: 测试服务端运行状态，0: unavailable，1: network ok，2: service ok，3: service degraded，4: exiting
-- -l PKTLEN: 网络测试时使用的测试包大小
-- -n NETROLE: 网络连接测试时的测试范围，默认为 `client`, 可选值为 `client`、`server`
-- -N PKTNUM: 网络测试时使用的测试包数量
-- -r: 将时间输出出无符号 64 位整数类型(即 C 语音中 uint64_t)
-- -R: 使用 RESTful 模式连接服务端
-- -s COMMAND: 以非交互模式执行的 SQL 命令
-- -t: 测试服务端启动状态，状态同-k
-- -w DISPLAYWIDTH: 客户端列显示宽度
-- -z TIMEZONE: 指定时区，默认为本地时区
-- -V: 打印出当前版本号
-
-示例：
-
-```bash
-taos -h h1.taos.com -s "use db; show tables;"
-```
-
-## 配置文件
-
-也可以通过配置文件中的参数设置来控制 TDengine CLI 的行为。可用配置参数请参考[客户端配置](../../components/taosc)
-
-## TDengine CLI 小技巧
-
-- 可以使用上下光标键查看历史输入的指令
-- 在 TDengine CLI 中使用 `alter user` 命令可以修改用户密码，缺省密码为 `taosdata`
-- Ctrl+C 中止正在进行中的查询
-- 执行 `RESET QUERY CACHE` 可清除本地表 Schema 的缓存
-- 批量执行 SQL 语句。可以将一系列的 TDengine CLI 命令（以英文 ; 结尾，每个 SQL 语句为一行）按行存放在文件里，在 TDengine CLI 里执行命令 `source <file-name>` 自动执行该文件里所有的 SQL 语句
-- 输入 `q` 或 `quit` 或 `exit` 回车，可以退出 TDengine CLI
-
-## TDengine CLI 导出查询结果到文件中
-
-- 可以使用符号 “>>” 导出查询结果到某个文件中，语法为： sql 查询语句 >> ‘输出文件名’; 输出文件如果不写路径的话，将输出至当前目录下。如 select * from d0 >> ‘/root/d0.csv’;  将把查询结果输出到 /root/d0.csv 中。
-
-## TDengine CLI 导入文件中的数据到表中
-
-- 可以使用 insert into table_name file '输入文件名'，把上一步中导出的数据文件再导入到指定表中。如 insert into d0 file '/root/d0.csv'; 表示把上面导出的数据全部再导致至 d0 表中。

docs/zh/14-reference/01-components/09-taosdump.md

@@ -1,127 +0,0 @@
----
-title: taosdump 参考手册
-sidebar_label: taosdump
-toc_max_heading_level: 4
----
-
-taosdump 是一个支持从运行中的 TDengine 集群备份数据并将备份的数据恢复到相同或另一个运行中的 TDengine 集群中的工具应用程序。
-
-taosdump 可以用数据库、超级表或普通表作为逻辑数据单元进行备份，也可以对数据库、超级
-表和普通表中指定时间段内的数据记录进行备份。使用时可以指定数据备份的目录路径，如果
-不指定位置，taosdump 默认会将数据备份到当前目录。
-
-如果指定的位置已经有数据文件，taosdump 会提示用户并立即退出，避免数据被覆盖。这意味着同一路径只能被用于一次备份。
-如果看到相关提示，请小心操作。
-
-taosdump 是一个逻辑备份工具，它不应被用于备份任何原始数据、环境设置、
-硬件信息、服务端配置或集群的拓扑结构。taosdump 使用
-[ Apache AVRO ](https://avro.apache.org/)作为数据文件格式来存储备份数据。
-
-## 安装
-
-taosdump 有两种安装方式:
-
-- 安装 taosTools 官方安装包, 请从[发布历史页面](https://docs.taosdata.com/releases/tools/)页面找到 taosTools 并下载安装。
-
-- 单独编译 taos-tools 并安装, 详情请参考 [taos-tools](https://github.com/taosdata/taos-tools) 仓库。
-
-## 常用使用场景
-
-### taosdump 备份数据
-
-1.  备份所有数据库：指定 `-A` 或 `--all-databases` 参数；
-2.  备份多个指定数据库：使用 `-D db1,db2,...` 参数；
-3.  备份指定数据库中的某些超级表或普通表：使用 `dbname stbname1 stbname2 tbname1 tbname2 ...` 参数，注意这种输入序列第一个参数为数据库名称，且只支持一个数据库，第二个和之后的参数为该数据库中的超级表或普通表名称，中间以空格分隔；
-4.  备份系统 log 库：TDengine 集群通常会包含一个系统数据库，名为 `log`，这个数据库内的数据为 TDengine 自我运行的数据，taosdump 默认不会对 log 库进行备份。如果有特定需求对 log 库进行备份，可以使用 `-a` 或 `--allow-sys` 命令行参数。
-5.  “宽容”模式备份：taosdump 1.4.1 之后的版本提供 `-n` 参数和 `-L` 参数，用于备份数据时不使用转义字符和“宽容”模式，可以在表名、列名、标签名没使用转义字符的情况下减少备份数据时间和备份数据占用空间。如果不确定符合使用 `-n` 和 `-L` 条件时请使用默认参数进行“严格”模式进行备份。转义字符的说明请参考[官方文档](../../taos-sql/escape)。
-
-:::tip
-- taosdump 1.4.1 之后的版本提供 `-I` 参数，用于解析 avro 文件 schema 和数据，如果指定 `-s` 参数将只解析 schema。
-- taosdump 1.4.2 之后的备份使用 `-B` 参数指定的批次数，默认值为 16384，如果在某些环境下由于网络速度或磁盘性能不足导致 "Error actual dump .. batch .." 可以通过 `-B` 参数调整为更小的值进行尝试。
-- taosdump 的导出不支持中断恢复，所以当进程意外终止后，正确的处理方式是删除当前已导出或生成的所有相关文件。
-- taosdump 的导入支持中断恢复，但是当进程重新启动时，会收到一些“表已经存在”的提示，可以忽视。
-
-:::
-
-### taosdump 恢复数据
-
-恢复指定路径下的数据文件：使用 `-i` 参数加上数据文件所在路径。如前面提及，不应该使用同一个目录备份不同数据集合，也不应该在同一路径多次备份同一数据集，否则备份数据会造成覆盖或多次备份。
-
-:::tip
-taosdump 内部使用 TDengine stmt binding API 进行恢复数据的写入，为提高数据恢复性能，目前使用 16384 为一次写入批次。如果备份数据中有比较多列数据，可能会导致产生 "WAL size exceeds limit" 错误，此时可以通过使用 `-B` 参数调整为一个更小的值进行尝试。
-
-:::
-
-## 详细命令行参数列表
-
-以下为 taosdump 详细命令行参数列表：
-
-```
-Usage: taosdump [OPTION...] dbname [tbname ...]
-  or:  taosdump [OPTION...] --databases db1,db2,...
-  or:  taosdump [OPTION...] --all-databases
-  or:  taosdump [OPTION...] -i inpath
-  or:  taosdump [OPTION...] -o outpath
-
-  -h, --host=HOST            Server host dumping data from. Default is
-                             localhost.
-  -p, --password             User password to connect to server. Default is
-                             taosdata.
-  -P, --port=PORT            Port to connect
-  -u, --user=USER            User name used to connect to server. Default is
-                             root.
-  -c, --config-dir=CONFIG_DIR   Configure directory. Default is /etc/taos
-  -i, --inpath=INPATH        Input file path.
-  -o, --outpath=OUTPATH      Output file path.
-  -r, --resultFile=RESULTFILE   DumpOut/In Result file path and name.
-  -a, --allow-sys            Allow to dump system database
-  -A, --all-databases        Dump all databases.
-  -D, --databases=DATABASES  Dump inputted databases. Use comma to separate
-                             databases' name.
-  -e, --escape-character     Use escaped character for database name
-  -N, --without-property     Dump database without its properties.
-  -s, --schemaonly           Only dump tables' schema.
-  -d, --avro-codec=snappy    Choose an avro codec among null, deflate, snappy,
-                             and lzma.
-  -S, --start-time=START_TIME   Start time to dump. Either epoch or
-                             ISO8601/RFC3339 format is acceptable. ISO8601
-                             format example: 2017-10-01T00:00:00.000+0800 or
-                             2017-10-0100:00:00:000+0800 or '2017-10-01
-                             00:00:00.000+0800'
-  -E, --end-time=END_TIME    End time to dump. Either epoch or ISO8601/RFC3339
-                             format is acceptable. ISO8601 format example:
-                             2017-10-01T00:00:00.000+0800 or
-                             2017-10-0100:00:00.000+0800 or '2017-10-01
-                             00:00:00.000+0800'
-  -B, --data-batch=DATA_BATCH   Number of data per query/insert statement when
-                             backup/restore. Default value is 16384. If you see
-                             'error actual dump .. batch ..' when backup or if
-                             you see 'WAL size exceeds limit' error when
-                             restore, please adjust the value to a smaller one
-                             and try. The workable value is related to the
-                             length of the row and type of table schema.
-  -I, --inspect              inspect avro file content and print on screen
-  -L, --loose-mode           Using loose mode if the table name and column name
-                             use letter and number only. Default is NOT.
-  -n, --no-escape            No escape char '`'. Default is using it.
-  -Q, --dot-replace          Repalce dot character with underline character in
-                             the table name.(Version 2.5.3)
-  -T, --thread-num=THREAD_NUM   Number of thread for dump in file. Default is
-                             8.
-  -C, --cloud=CLOUD_DSN      specify a DSN to access TDengine cloud service
-  -R, --restful              Use RESTful interface to connect TDengine
-  -t, --timeout=SECONDS      The timeout seconds for websocket to interact.
-  -g, --debug                Print debug info.
-  -?, --help                 Give this help list
-      --usage                Give a short usage message
-  -V, --version              Print program version
-  -W, --rename=RENAME-LIST   Rename database name with new name during
-                             importing data. RENAME-LIST: 
-                             "db1=newDB1|db2=newDB2" means rename db1 to newDB1
-                             and rename db2 to newDB2 (Version 2.5.4)
-
-Mandatory or optional arguments to long options are also mandatory or optional
-for any corresponding short options.
-
-Report bugs to <support@taosdata.com>.
-```