Merge pull request #12661 from taosdata/docs/wade-20220518

docs: refine the format in faq.md

docs-cn/27-train-faq/01-faq.md

@@ -21,7 +21,7 @@ title: 常见问题及反馈
 
 ## 常见问题列表
 
-**1. TDengine2.0 之前的版本升级到 2.0 及以上的版本应该注意什么？☆☆☆**
+### 1. TDengine2.0 之前的版本升级到 2.0 及以上的版本应该注意什么？☆☆☆
 
     2.0 版在之前版本的基础上，进行了完全的重构，配置文件和数据文件是不兼容的。在升级之前务必进行如下操作：
 
@@ -31,19 +31,19 @@ title: 常见问题及反馈
     4. 安装最新稳定版本的 TDengine
     5. 如果需要迁移数据或者数据文件损坏，请联系涛思数据官方技术支持团队，进行协助解决
 
-**2. Windows 平台下 JDBCDriver 找不到动态链接库，怎么办？**
+### 2. Windows 平台下 JDBCDriver 找不到动态链接库，怎么办？
 
     请看为此问题撰写的[技术博客](https://www.taosdata.com/blog/2019/12/03/950.html)。
 
-**3. 创建数据表时提示 more dnodes are needed**
+### 3. 创建数据表时提示 more dnodes are needed
 
     请看为此问题撰写的[技术博客](https://www.taosdata.com/blog/2019/12/03/965.html)。
 
-**4. 如何让 TDengine crash 时生成 core 文件？**
+### 4. 如何让 TDengine crash 时生成 core 文件？
 
     请看为此问题撰写的[技术博客](https://www.taosdata.com/blog/2019/12/06/974.html)。
 
-**5. 遇到错误“Unable to establish connection”, 我怎么办？**
+### 5. 遇到错误“Unable to establish connection” 怎么办？
 
     客户端遇到连接故障，请按照下面的步骤进行检查：
 
@@ -78,7 +78,7 @@ title: 常见问题及反馈
 
     10. 也可以使用 taos 程序内嵌的网络连通检测功能，来验证服务器和客户端之间指定的端口连接是否通畅（包括 TCP 和 UDP）：[TDengine 内嵌网络检测工具使用指南](https://www.taosdata.com/blog/2020/09/08/1816.html)。
 
-**6. 遇到错误“Unexpected generic error in RPC”或者“Unable to resolve FQDN”，我怎么办？**
+### 6. 遇到错误 “Unexpected generic error in RPC”或者“Unable to resolve FQDN” 怎么办？
 
     产生这个错误，是由于客户端或数据节点无法解析 FQDN(Fully Qualified Domain Name)导致。对于 TAOS Shell 或客户端应用，请做如下检查：
 
@@ -89,17 +89,17 @@ title: 常见问题及反馈
     5. 如果服务器曾经使用过 TDengine，且更改过 hostname，建议检查 data 目录的 dnodeEps.json 是否符合当前配置的 EP，路径默认为/var/lib/taos/dnode。正常情况下，建议更换新的数据目录或者备份后删除以前的数据目录，这样可以避免该问题。
     6. 检查/etc/hosts 和/etc/hostname 是否是预配置的 FQDN
 
-**7. 虽然语法正确，为什么我还是得到 "Invalid SQL" 错误**
+### 7. 虽然语法正确，为什么我还是得到 "Invalid SQL" 错误？
 
     如果你确认语法正确，2.0 之前版本，请检查 SQL 语句长度是否超过 64K。如果超过，也会返回这个错误。
 
-**8. 是否支持 validation queries？**
+### 8. 是否支持 validation queries？
 
     TDengine 还没有一组专用的 validation queries。然而建议你使用系统监测的数据库”log"来做。
 
 <a class="anchor" id="update"></a>
 
-**9. 我可以删除或更新一条记录吗？**
+### 9. 我可以删除或更新一条记录吗？
 
     TDengine 目前尚不支持删除功能，未来根据用户需求可能会支持。
 
@@ -109,15 +109,15 @@ title: 常见问题及反馈
 
     此外，从 2.1.7.0 版本开始，支持将 UPDATE 参数设为 2，表示“支持部分列更新”。也即，当 UPDATE 设为 1 时，如果更新一个数据行，其中某些列没有提供取值，那么这些列会被设为 NULL；而当 UPDATE 设为 2 时，如果更新一个数据行，其中某些列没有提供取值，那么这些列会保持原有数据行中的对应值。
 
-**10. 我怎么创建超过 1024 列的表？**
+### 10. 我怎么创建超过 1024 列的表？
 
     使用 2.0 及其以上版本，默认支持 1024 列；2.0 之前的版本，TDengine 最大允许创建 250 列的表。但是如果确实超过限值，建议按照数据特性，逻辑地将这个宽表分解成几个小表。（从 2.1.7.0 版本开始，表的最大列数增加到了 4096 列。）
 
-**11. 最有效的写入数据的方法是什么？**
+### 11. 最有效的写入数据的方法是什么？
 
     批量插入。每条写入语句可以一张表同时插入多条记录，也可以同时插入多张表的多条记录。
 
-**12. Windows 系统下插入的 nchar 类数据中的汉字被解析成了乱码如何解决？**
+### 12. Windows 系统下插入的 nchar 类数据中的汉字被解析成了乱码如何解决？
 
     Windows 下插入 nchar 类的数据中如果有中文，请先确认系统的地区设置成了中国（在 Control Panel 里可以设置），这时 cmd 中的`taos`客户端应该已经可以正常工作了；如果是在 IDE 里开发 Java 应用，比如 Eclipse， IntelliJ，请确认 IDE 里的文件编码为 GBK（这是 Java 默认的编码类型），然后在生成 Connection 时，初始化客户端的配置，具体语句如下：
 
@@ -128,7 +128,7 @@ title: 常见问题及反馈
     Connection = DriverManager.getConnection(url, properties);
     ```
 
-**13.JDBC 报错： the executed SQL is not a DML or a DDL？**
+### 13.JDBC 报错： the executed SQL is not a DML or a DDL？
 
     请更新至最新的 JDBC 驱动
 
@@ -140,15 +140,15 @@ title: 常见问题及反馈
     </dependency>
     ```
 
-**14. taos connect failed, reason&#58; invalid timestamp**
+### 14. taos connect failed, reason&#58; invalid timestamp
 
     常见原因是服务器和客户端时间没有校准，可以通过和时间服务器同步的方式（Linux 下使用 ntpdate 命令，Windows 在系统时间设置中选择自动同步）校准。
 
-**15. 表名显示不全**
+### 15. 表名显示不全
 
     由于 taos shell 在终端中显示宽度有限，有可能比较长的表名显示不全，如果按照显示的不全的表名进行相关操作会发生 Table does not exist 错误。解决方法可以是通过修改 taos.cfg 文件中的设置项 maxBinaryDisplayWidth， 或者直接输入命令 set max_binary_display_width 100。或者在命令结尾使用 \G 参数来调整结果的显示方式。
 
-**16. 如何进行数据迁移？**
+### 16. 如何进行数据迁移？
 
     TDengine 是根据 hostname 唯一标志一台机器的，在数据文件从机器 A 移动机器 B 时，注意如下两件事：
 
@@ -156,7 +156,7 @@ title: 常见问题及反馈
      - 2.0.7.0 及以后的版本，到/var/lib/taos/dnode 下，修复 dnodeEps.json 的 dnodeId 对应的 FQDN，重启。确保机器内所有机器的此文件是完全相同的。
      - 1.x 和 2.x 版本的存储结构不兼容，需要使用迁移工具或者自己开发应用导出导入数据。
 
-**17. 如何在命令行程序 taos 中临时调整日志级别**
+### 17. 如何在命令行程序 taos 中临时调整日志级别
 
     为了调试方便，从 2.0.16 版本开始，命令行程序 taos 新增了与日志记录相关的两条指令：
 
@@ -177,7 +177,7 @@ title: 常见问题及反馈
 
 <a class="anchor" id="timezone"></a>
 
-**18. go 语言编写组件编译失败怎样解决？**
+### 18. go 语言编写组件编译失败怎样解决？
 
     TDengine 2.3.0.0 及之后的版本包含一个使用 go 语言开发的 taosAdapter 独立组件，需要单独运行，取代之前 taosd 内置的 httpd ，提供包含原 httpd 功能以及支持多种其他软件（Prometheus、Telegraf、collectd、StatsD 等）的数据接入功能。
     使用最新 develop 分支代码编译需要先 `git submodule update --init --recursive` 下载 taosAdapter 仓库代码后再编译。
@@ -192,7 +192,7 @@ title: 常见问题及反馈
     如果希望继续使用之前的内置 httpd，可以关闭 taosAdapter 编译，使用
     `cmake .. -DBUILD_HTTP=true` 使用原来内置的 httpd。
 
-**19. 如何查询数据占用的存储空间大小？**
+### 19. 如何查询数据占用的存储空间大小？
 
     默认情况下，TDengine 的数据文件存储在 /var/lib/taos ，日志文件存储在 /var/log/taos 。
 

docs-en/27-train-faq/01-faq.md

@@ -9,7 +9,7 @@ If the tips in FAQ don't help much, please submit an issue on  [GitHub](https://
 
 ## Frequently Asked Questions
 
-**1. How to upgrade to TDengine 2.0 from older version? ☆☆☆**
+### 1. How to upgrade to TDengine 2.0 from older version?
 
     version 2.x is not compatible with version 1.x regarding configuration file and data file, please do following before upgrading:
 
@@ -19,7 +19,7 @@ If the tips in FAQ don't help much, please submit an issue on  [GitHub](https://
     4. Install latests 2.x version
     5. If the data needs to be kept and migrated to newer version, please contact professional service of TDengine for assistance
 
-**2. How to handle "Unable to establish connection"**
+### 2. How to handle "Unable to establish connection"？
 
     When the client is unable to connect to the server, you can try following ways to find out why.
 
@@ -49,7 +49,7 @@ If the tips in FAQ don't help much, please submit an issue on  [GitHub](https://
 
     7.  TDengine CLI `taos` can also be used to check network, please refer to [TDengine CLI](/reference/taos-shell).
 
-**3. How to handle "Unexpected generic error in RPC" or  "Unable to resolve FQDN" ?**
+### 3. How to handle "Unexpected generic error in RPC" or  "Unable to resolve FQDN" ?
 
     This error is caused because the FQDN can't be resolved. Please try following ways:
 
@@ -58,41 +58,41 @@ If the tips in FAQ don't help much, please submit an issue on  [GitHub](https://
     3. If the network configuration on the server side is OK, try to ping the server from the client side.
     4. If TDengine has been used before with an old hostname then the hostname has been changed, please check `/var/lib/taos/taos/dnode/dnodeEps.json`. Before setting up a new TDengine cluster, it's better to cleanup the directories configured.
 
-**4. "Invalid SQL" is returned even though the Syntax is correct**
+### 4. "Invalid SQL" is returned even though the Syntax is correct
 
     "Invalid SQL" is returned when the length of SQL statement exceeds maximum allowed length or the syntax is not correct.
 
-**5. Whether validation queries are supported?**
+### 5. Whether validation queries are supported?
 
     It's suggested to use a builtin database named as `log` to monitor.
 
 <a class="anchor" id="update"></a>
 
-**6. Can I delete a record?**
+### 6. Can I delete a record?
 
     From version 2.6.0.0 Enterprise version, deleting data can be supported.
 
-**7. How to create a table of over 1024 columns?**
+### 7. How to create a table of over 1024 columns?
 
     From version 2.1.7.0, at most 4096 columns can be defined for a table.
 
-**8. How to improve the efficiency of inserting data?**
+### 8. How to improve the efficiency of inserting data?
 
     Inserting data in batch is a good practice. Single SQL statement can insert data for one or multiple tables in batch.
 
-**9. JDBC Error： the excuted SQL is not a DML or a DDL？**
+### 9. JDBC Error： the excuted SQL is not a DML or a DDL？
 
     Please upgrade to latest JDBC driver, for details please refer to [Java Connector](/reference/connector/java)
 
-**10. Failed to connect with error  "invalid timestamp"**
+### 10. Failed to connect with error  "invalid timestamp"
 
     The most common reason is that the time setting is not aligned on the client side and the server side. On Linux system, please use `ntpdate` command. On Windows system, please enable automatic sync in system time setting.
 
-**11. Table name is not shown in full**
+### 11. Table name is not shown in full
 
     There is a display width setting in TDengine CLI `taos`. It can be controlled by configuration parameter `maxBinaryDisplayWidth`, or can be set using SQL command `set max_binary_display_width`. A more convenient way is to append `\G` in a SQL command to bypass this limitation.
 
-**12. How to change log level temporarily?**
+### 12. How to change log level temporarily?
 
     Below SQL command can be used to adjust log level temporarily
 
@@ -105,7 +105,7 @@ If the tips in FAQ don't help much, please submit an issue on  [GitHub](https://
 <a class="anchor" id="timezone"></a>
 
 
-**13. Hhat to do if go compilation fails?**
+### 13. Hhat to do if go compilation fails?
 
     From version 2.3.0.0, a new component named `taosAdapter` is introduced. Its' developed in Go. If you want to compile from source code and meet go compilation problems, try to do below steps to resolve Go environment problems.