常见问题及反馈

问题反馈

如果 FAQ 中的信息不能够帮到您，需要 TDengine TSDB 技术团队的技术支持与协助，请将以下两个目录中内容打包：

/var/log/taos （如果没有修改过默认路径）
/etc/taos （如果没有指定其他配置文件路径）

附上必要的问题描述，包括使用的 TDengine TSDB 版本信息、平台环境信息、发生该问题的执行操作、出现问题的表征及大概的时间，在 GitHub 提交 issue。

为了保证有足够的 debug 信息，如果问题能够重复，请修改 /etc/taos/taos.cfg 文件，最后面添加一行 debugFlag 135，然后重启 taosd, 重复问题，然后再递交。也可以通过如下 SQL 语句，临时设置 taosd 的日志级别。

  alter dnode <dnode_id> 'debugFlag' '135';

其中 dnode_id 请从 show dnodes 命令输出中获取。

但系统正常运行时，请一定将 debugFlag 设置为 131，否则会产生大量的日志信息，降低系统效率。

常见问题列表

1. TDengine TSDB 3.0 之前的版本升级到 3.0 及以上的版本应该注意什么？

3.0 版在之前版本的基础上，进行了完全的重构，配置文件和数据文件是不兼容的。在升级之前务必进行如下操作：

删除配置文件，执行 sudo rm -rf /etc/taos/taos.cfg
删除日志文件，执行 sudo rm -rf /var/log/taos/
确保数据已经不再需要的前提下，删除数据文件，执行 sudo rm -rf /var/lib/taos/
安装最新 3.0 稳定版本的 TDengine TSDB
如果需要迁移数据或者数据文件损坏，请联系涛思数据官方技术支持团队，进行协助解决

2. Windows 平台下 JDBCDriver 找不到动态链接库，怎么办？

请看为此问题撰写的技术博客。

3. 遇到加载`libtaosnative.so`或`libtaosws.so`失败怎么办？

问题描述：在使用 TDengine TSDB 客户端应用（taos-CLI、taosBenchmark、taosdump 等）或客户端连接器（如 Java、Python、Go 等）时，可能会遇到加载动态链接库libtaosnative.so或libtaosws.so失败的错误。如：failed to load libtaosws.so since No such file or directory [0x80FF0002]

问题原因：这是由于客户端无法找到所需的动态链接库文件，可能是因为文件未正确安装，或系统的库路径未正确配置等原因。

问题解决：

检查文件：检查系统共享库目录下是否存在 libtaosnative.so 或 libtaosws.so 软链文件及相应实体文件也完整，如软链或实体文件已不存在，在 TDengine TSDB 客户端或服务器安装包中均包含这些文件，请重新安装。
检查环境变量：确保系统加载共享库目录环境变量LD_LIBRARY_PATH 包含 libtaosnative.so 或 libtaosws.so 文件所在目录，若未包含，可通过 export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<new_path> 添加。
检查权限：确保当前用户对 libtaosnative.so 或 libtaosws.so 软链及其实体文件具有读取和执行权限。
检查文件损坏：可以通过 readelf -h 库文件 检查库文件是否完整。
检查文件依赖：可以通过 ldd 库文件 查看库文件的依赖项是否完整，确保所有依赖项均已正确安装且可访问。

4. 如何让 TDengine TSDB crash 时生成 core 文件？

请看为此问题撰写的技术博客。

5. 遇到错误 "Unable to establish connection" 怎么办？

客户端遇到连接故障，请按照下面的步骤进行检查：

检查网络环境

云服务器：检查云服务器的安全组是否打开 TCP/UDP 端口 6030/6041 的访问权限
本地虚拟机：检查网络能否 ping 通，尽量避免使用 localhost 作为 hostname
公司服务器：如果为 NAT 网络环境，请务必检查服务器能否将消息返回值客户端

确保客户端与服务端版本号是完全一致的，开源社区版和企业版也不能混用
在服务器，执行 systemctl status taosd 检查 taosd 运行状态。如果没有运行，启动 taosd
确认客户端连接时指定了正确的服务器 FQDN (Fully Qualified Domain Name —— 可在服务器上执行 Linux/macOS 命令 hostname -f 获得），FQDN 配置参考一篇文章说清楚 TDengine 的 FQDN。
ping 服务器 FQDN，如果没有反应，请检查你的网络，DNS 设置，或客户端所在计算机的系统 hosts 文件。如果部署的是 TDengine 集群，客户端需要能 ping 通所有集群节点的 FQDN。
检查防火墙设置（Ubuntu 使用 ufw status，CentOS 使用 firewall-cmd --list-port），确保集群中所有主机在端口 6030/6041 上的 TCP/UDP 协议能够互通。
对于 Linux 上的 JDBC（ODBC、Python、Go 等接口类似）连接，确保 libtaos.so 在目录 /usr/local/taos/driver 里，并且 /usr/local/taos/driver 在系统库函数搜索路径 LD_LIBRARY_PATH 里
对于 macOS 上的 JDBC（ODBC、Python、Go 等接口类似）连接，确保 libtaos.dylib 在目录 /usr/local/lib 里，并且 /usr/local/lib 在系统库函数搜索路径 LD_LIBRARY_PATH 里
对于 Windows 上的 JDBC、ODBC、Python、Go 等连接，确保 C:\TDengine\driver\taos.dll 在你的系统库函数搜索目录里 (建议 taos.dll 放在目录 C:\Windows\System32)
如果仍不能排除连接故障

Linux/macOS 系统请使用命令行工具 nc 来分别判断指定端口的 TCP 和 UDP 连接是否通畅检查 UDP 端口连接是否工作：nc -vuz {hostIP} {port} 检查服务器侧 TCP 端口连接是否工作：nc -l {port} 检查客户端侧 TCP 端口连接是否工作：nc {hostIP} {port}
Windows 系统请使用 PowerShell 命令 Test-NetConnection -ComputerName \{fqdn} -Port \{port} 检测服务段端口是否访问

也可以使用 taos 程序内嵌的网络连通检测功能，来验证服务器和客户端之间指定的端口连接是否通畅：运维指南。

6. 遇到错误 "Unable to resolve FQDN" 怎么办？

产生这个错误，是由于客户端或数据节点无法解析 FQDN(Fully Qualified Domain Name) 导致。对于 TDengine TSDB CLI 或客户端应用，请做如下检查：

请检查连接的服务器的 FQDN 是否正确，FQDN 配置参考：一篇文章说清楚 TDengine 的 FQDN
如果网络配置有 DNS server，请检查是否正常工作
如果网络没有配置 DNS server，请检查客户端所在机器的 hosts 文件，查看该 FQDN 是否配置，并是否有正确的 IP 地址
如果网络配置 OK，从客户端所在机器，你需要能 Ping 该连接的 FQDN，否则客户端是无法连接服务器的
如果服务器曾经使用过 TDengine TSDB，且更改过 hostname，建议检查 data 目录的 dnode.json 是否符合当前配置的 EP，路径默认为/var/lib/taos/dnode。正常情况下，建议更换新的数据目录或者备份后删除以前的数据目录，这样可以避免该问题。
检查 /etc/hosts 和/etc/hostname 是否是预配置的 FQDN

7. 最有效的写入数据的方法是什么？

批量插入。每条写入语句可以一张表同时插入多条记录，也可以同时插入多张表的多条记录。

8. Windows 系统下插入的 nchar 类数据中的汉字被解析成了乱码如何解决？

Windows 下插入 nchar 类的数据中如果有中文，请先确认系统的地区设置成了中国（在 Control Panel 里可以设置），这时 cmd 中的 taos 客户端应该已经可以正常工作了；如果是在 IDE 里开发 Java 应用，比如 Eclipse，IntelliJ，请确认 IDE 里的文件编码为 GBK（这是 Java 默认的编码类型），然后在生成 Connection 时，初始化客户端的配置，具体语句如下：

Class.forName("com.taosdata.jdbc.TSDBDriver");
Properties properties = new Properties();
properties.setProperty(TSDBDriver.LOCALE_KEY, "UTF-8");
Connection = DriverManager.getConnection(url, properties);

9. Windows 系统下客户端无法正常显示中文字符？

Windows 系统中一般是采用 GBK/GB18030 存储中文字符，而 TDengine TSDB 的默认字符集为 UTF-8，在 Windows 系统中使用 TDengine TSDB 客户端时，客户端驱动会将字符统一转换为 UTF-8 编码后发送到服务端存储，因此在应用开发过程中，调用接口时正确配置当前的中文字符集即可。

在 Windows 10 环境下运行 TDengine TSDB 客户端命令行工具 taos 时，若无法正常输入、显示中文，可以对客户端 taos.cfg 做如下配置：

locale C 
charset UTF-8

10. 表名显示不全

由于 TDengine TSDB CLI 在终端中显示宽度有限，有可能比较长的表名显示不全，如果按照显示的不全的表名进行相关操作会发生 Table does not exist 错误。解决方法可以是通过修改 taos.cfg 文件中的设置项 maxBinaryDisplayWidth，或者直接输入命令 set max_binary_display_width 100。或者在命令结尾使用 \G 参数来调整结果的显示方式。

11. 如何进行数据迁移？

TDengine TSDB 是根据 hostname 唯一标志一台机器的，对于 3.0 版本，将数据文件从机器 A 移动机器 B 时，需要重新配置机器 B 的 hostname 为机器 A 的 hostname。

注：3.x 和之前的 1.x、2.x 版本的存储结构不兼容，需要使用迁移工具或者自己开发应用导出导入数据。

12. 如何在命令行程序 taos 中临时调整日志级别

为了调试方便，命令行程序 taos 新增了与日志记录相关的指令：

ALTER LOCAL local_option
 
local_option: {
    'resetLog'
  | 'rpcDebugFlag' 'value'
  | 'tmrDebugFlag' 'value'
  | 'cDebugFlag' 'value'
  | 'uDebugFlag' 'value'
  | 'debugFlag' 'value'
}

其含义是，在当前的命令行程序下，清空本机所有客户端生成的日志文件 (resetLog)，或修改一个特定模块的日志记录级别（只对当前命令行程序有效，如果 taos 命令行程序重启，则需要重新设置）：

value 的取值可以是：131（输出错误和警告日志）、135（输出错误、警告和调试日志）、143（输出错误、警告、调试和跟踪日志）。

13. go 语言编写组件编译失败怎样解决？

TDengine TSDB 3.0 版本包含一个使用 go 语言开发的 taosAdapter 独立组件，需要单独运行，提供 restful 接入功能以及支持多种其他软件（Prometheus、Telegraf、collectd、StatsD 等）的数据接入功能。使用最新 develop 分支代码编译需要先 git submodule update --init --recursive 下载 taosAdapter 仓库代码后再编译。

go 语言版本要求 1.14 以上，如果发生 go 编译错误，往往是国内访问 go mod 问题，可以通过设置 go 环境变量来解决：

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

14. 如何查询数据占用的存储空间大小？

默认情况下，TDengine TSDB 的数据文件存储在 /var/lib/taos，日志文件存储在 /var/log/taos。

若想查看所有数据文件占用的具体大小，可以执行 Shell 指令：du -sh /var/lib/taos/vnode --exclude='wal' 来查看。此处排除了 WAL 目录，因为在持续写入的情况下，这里大小几乎是固定的，并且每当正常关闭 TDengine TSDB 让数据落盘后，WAL 目录都会清空。

若想查看单个数据库占用的大小，可在命令行程序 taos 内指定要查看的数据库后执行 show vgroups; ，通过得到的 VGroup id 去 /var/lib/taos/vnode 下查看包含的文件夹大小。

15. 客户端连接串如何保证高可用？

请看为此问题撰写的技术博客

16. 时间戳的时区信息是怎样处理的？

TDengine TSDB 中时间戳的时区总是由客户端进行处理，而与服务端无关。具体来说，客户端会对 SQL 语句中的时间戳进行时区转换，转为 UTC 时区（即 Unix 时间戳——Unix Timestamp）再交由服务端进行写入和查询；在读取数据时，服务端也是采用 UTC 时区提供原始数据，客户端收到后再根据本地设置，把时间戳转换为本地系统所要求的时区进行显示。

客户端在处理时间戳字符串时，会采取如下逻辑：

在未做特殊设置的情况下，客户端默认使用所在操作系统的时区设置。
如果在 taos.cfg 中设置了 timezone 参数，则客户端会以这个配置文件中的设置为准。
如果在 C/C++/Java/Python 等各种编程语言的 Connector Driver 中，在建立数据库连接时显式指定了 timezone，那么会以这个指定的时区设置为准。例如 Java Connector 的 JDBC URL 中就有 timezone 参数。
在书写 SQL 语句时，也可以直接使用 Unix 时间戳（例如 1554984068000）或带有时区的时间戳字符串，也即以 RFC 3339 格式（例如 2013-04-12T15:52:01.123+08:00）或 ISO-8601 格式（例如 2013-04-12T15:52:01.123+0800）来书写时间戳，此时这些时间戳的取值将不再受其他时区设置的影响。

17. TDengine TSDB 3.0 都会用到哪些网络端口？

使用到的网络端口请看文档：运维指南

需要注意，文档上列举的端口号都是以默认端口 6030 为前提进行说明，如果修改了配置文件中的设置，那么列举的端口都会随之出现变化，管理员可以参考上述的信息调整防火墙设置。

18. 为什么 RESTful 接口无响应、Grafana 无法添加 TDengine TSDB 为数据源、TDengine TSDB GUI 选了 6041 端口还是无法连接成功？

这个现象可能是因为 taosAdapter 没有被正确启动引起的，需要执行：systemctl start taosadapter 命令来启动 taosAdapter 服务。

需要说明的是，taosAdapter 的日志路径 path 需要单独配置，默认路径是 /var/log/taos；日志等级 logLevel 有 8 个等级，默认等级是 info，配置成 panic 可关闭日志输出。请注意操作系统 / 目录的空间大小，可通过命令行参数、环境变量或配置文件来修改配置，默认配置文件是 /etc/taos/taosadapter.toml。

有关 taosAdapter 组件的详细介绍请看文档：taosAdapter

19. 发生了 OOM 怎么办？

OOM 是操作系统的保护机制，当操作系统内存 (包括 SWAP) 不足时，会杀掉某些进程，从而保证操作系统的稳定运行。通常内存不足主要是如下两个原因导致，一是剩余内存小于 vm.min_free_kbytes；二是程序请求的内存大于剩余内存。还有一种情况是内存充足但程序占用了特殊的内存地址，也会触发 OOM。

TDengine TSDB 会预先为每个 VNode 分配好内存，每个 Database 的 VNode 个数受建库时的 vgroups 参数影响，每个 VNode 占用的内存大小受 buffer 参数影响。要防止 OOM，需要在项目建设之初合理规划内存，并合理设置 SWAP，除此之外查询过量的数据也有可能导致内存暴涨，这取决于具体的查询语句。TDengine TSDB 企业版对内存管理做了优化，采用了新的内存分配器，对稳定性有更高要求的用户可以考虑选择企业版。

20. 在 macOS 上遇到 Too many open files 怎么办？

taosd 日志文件报错 Too many open file，是由于 taosd 打开文件数超过系统设置的上限所致。解决方案如下：

新建文件 /Library/LaunchDaemons/limit.maxfiles.plist，写入以下内容(以下示例将 limit 和 maxfiles 改为 10 万，可按需修改)：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
  <string>limit.maxfiles</string>
<key>ProgramArguments</key>
<array>
  <string>launchctl</string>
  <string>limit</string>
  <string>maxfiles</string>
  <string>100000</string>
  <string>100000</string>
</array>
<key>RunAtLoad</key>
  <true/>
<key>ServiceIPC</key>
  <false/>
</dict>
</plist>

修改文件权限

sudo chown root:wheel /Library/LaunchDaemons/limit.maxfiles.plist
sudo chmod 644 /Library/LaunchDaemons/limit.maxfiles.plist

加载 plist 文件 (或重启系统后生效。launchd 在启动时会自动加载该目录的 plist)

sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist

4.确认更改后的限制

launchctl limit maxfiles

21 建库时提示 Out of dnodes 或者建表时提示 Vnodes exhausted

该提示是创建 db 的 vnode 数量不够了，需要的 vnode 不能超过了 dnode 中 vnode 的上限。因为系统默认是一个 dnode 中有 CPU 核数两倍的 vnode，也可以通过配置文件中的参数 supportVnodes 控制。正常调大 taos.cfg 中 supportVnodes 参数即可。

22 在服务器上的使用 TDengine TSDB CLI 能查到指定时间段的数据，但在客户端机器上查不到？

这种情况是因为客户端与服务器上设置的时区不一致导致的，调整客户端与服务器的时区一致即可解决。

23 表名确认是存在的，但在写入或查询时返回表名不存在，什么原因？

TDengine TSDB 中的所有名称，包括数据库名、表名等都是区分大小写的，如果这些名称在程序或 TDengine TSDB CLI 中没有使用反引号（`）括起来使用，即使你输入的是大写的，引擎也会转化成小写来使用，如果名称前后加上了反引号，引擎就不会再转化成小写，会保持原样来使用。

24 在 TDengine TSDB CLI 中查询，字段内容不能完全显示出来怎么办？

可以使用 \G 参数来竖式显示，如 show databases\G; （为了输入方便，在""后加 TAB 键，会自动补全后面的内容）

25 使用 taosBenchmark 测试工具写入数据查询很快，为什么我写入的数据查询非常慢？

TDengine TSDB 在写入数据时如果有很严重的乱序写入问题，会严重影响查询性能，所以需要在写入前解决乱序的问题。如果业务是从 Kafka 消费写入，请合理设计消费者，尽可能的一个子表数据由一个消费者去消费并写入，避免由设计产生的乱序。

26 我想统计下前后两条写入记录之间的时间差值是多少？

使用 DIFF 函数，可以查看时间列或数值列前后两条记录的差值，非常方便，详细说明见 SQL 手册->函数->DIFF

27 遇到报错 "DND ERROR Version not compatible, client: 3000700, server: 3020300"

说明客户端和服务端版本不兼容，这里 client 的版本是 3.0.7.0，server 版本是 3.2.3.0。目前的兼容策略是前三位一致，client 和 sever 才能兼容。

28 修改 database 的 root 密码后，启动 taos 遇到报错 "failed to connect to server, reason: Authentication failure"

默认情况，启动 taos 服务会使用系统默认的用户名（root）和密码尝试连接 taosd，在 root 密码修改后，启用 taos 连接就需要指明用户名和密码，例如 taos -h xxx.xxx.xxx.xxx -u root -p，然后输入新密码进行连接。修改密码后，您还需要相应地修改 taosKeeper 组件的配置文件（默认位于 /etc/taos/taoskeeper.toml），修改其访问 TDengine TSDB 的密码后重启服务。

在 3.3.6.6 版本之后，针对 Docker 环境新增了 TAOS_ROOT_PASSWORD 环境变量，用于设置自定义密码。使用 docker run 命令启动容器时，添加 -e TAOS_ROOT_PASSWORD=<password> 参数，即可使用自定义密码启动 TDengine TSDB 服务，无需修改配置文件。

对于 3.3.6.6-3.3.8.4 版本，针对 Docker 环境，如果在旧版本修改了密码，则需要在data目录（默认/var/lib/taos）touch一个空文件.docker-entrypoint-root-password-changed，再次启动容器即可。

而对于 3.3.8.8 及以上的版本，针对 Docker 环境，直接升级即可。

29 修改 database 的 root 密码后，Grafana 监控插件 TDinsight 无数据展示

TDinsight 插件中展示的数据是通过 taosKeeper 和 taosAdapter 服务收集并存储于 TD 的 log 库中，在 root 密码修改后，需要同步更新 taosKeeper 和 taosAdapter 配置文件中对应的密码信息，然后重启 taosKeeper 和 taosAdapter 服务（注：若是集群需要重启每个节点上的对应服务）。

30 遇到报错 "some vnode/qnode/mnode(s) out of service" 怎么办？

客户端未配置所有服务端的 FQDN 解析。比如服务端有 3 个节点，客户端只配置了 1 个节点的 FQDN 解析。FQDN 配置参考：一篇文章说清楚 TDengine 的 FQDN

31 为什么开源版 TDengine TSDB 的主进程会建立一个与公网的连接？

这个连接只会上报不涉及任何用户数据的最基本信息，用于官方了解产品在世界范围内的分布情况，进而优化产品，提升用户体验，具体采集项目为：集群名、操作系统版本、cpu 信息等。

该特性为可选配置项，在开源版中默认开启，具体参数为 telemetryReporting，在官方文档中有做说明，链接如下：参数简介

您可以随时关闭该参数，只需要在 taos.cfg 中修改 telemetryReporting 为 0，然后重启数据库服务即可。

代码位于：点击此处

此外，对于安全性要求极高的企业版 TDengine TSDB Enterprise 来说，此参数不会工作。

32 第一次连接集群时遇到 "Sync leader is unreachable" 怎么办？

报这个错，说明第一次向集群的连接是成功的，但第一次访问的 IP 不是 mnode 的 leader 节点，客户端试图与 leader 建立连接时发生错误。客户端通过 EP，也就是指定的 fqdn 与端口号寻找 leader 节点，常见的报错原因有两个：

集群中其他节点的端口没有打开
客户端的 hosts 未正确配置

因此用户首先要检查服务端，集群的所有端口（原生连接默认 6030，http 连接默认 6041）有无打开；其次是客户端的 hosts 文件中是否配置了集群所有节点的 fqdn 与 IP 信息。如仍无法解决，则需要联系涛思技术人员支持。

33 同一台服务器，数据库的数据目录 dataDir 不变，为什么原有数据库丢失且集群 ID 发生了变化？

背景知识：TDengine TSDB 服务端进程（taosd）在启动时，若数据目录（dataDir，该目录在配置文件 taos.cfg 中指定）下不存在有效的数据文件子目录（如 mnode、dnode 和 vnode 等），则会自动创建这些目录。在创建新的 mnode 目录的同时，会分配一个新的集群 ID，从而产生一个新的集群。

原因分析：taosd 的数据目录 dataDir 可以指向多个不同的挂载点。如果这些挂载点未在 fstab 文件中配置自动挂载，服务器重启后，dataDir 将仅作为一个本地磁盘的普通目录存在，而未能按预期指向挂载的磁盘。此时，若 taosd 服务启动，它将在 dataDir 下新建目录，从而产生一个新的集群。

问题影响：服务器重启后，原有数据库丢失（注：并非真正丢失，只是原有的数据磁盘未挂载，暂时看不到）且集群 ID 发生变化，导致无法访问原有数据库。对于企业版用户，如果已针对集群 ID 进行授权，还会发现集群服务器的机器码未变，但原有的授权已失效。如果未针对该问题进行监控或者未及时发现并进行处理，则用户不会注意到原有数据库已经丢失，从而造成损失，增加运维成本。

问题解决：应在 fstab 文件中配置 dataDir 目录的自动挂载，确保 dataDir 始终指向预期的挂载点和目录，此时，再重启服务器，会找回原有的数据库和集群。在后续的版本中，我们将开发一个功能，使 taosd 在检测到启动前后 dataDir 发生变化时，在启动阶段退出，同时提供相应的错误提示。

34 Windows 平台运行 TDengine TSDB 出现丢失 MVCP1400.DLL 解决方法？

重新安装 Microsoft Visual C++ Redistributable‌：由于 msvcp140.dll 是 Microsoft Visual C++ Redistributable 的一部分，重新安装这个包通常可以解决大部分问题。可以从 Microsoft 官方网站下载相应的版本进行安装‌
手动上网下载并替换 msvcp140.dll 文件‌：可以从可靠的源下载 msvcp140.dll 文件，并将其复制到系统的相应目录下。确保下载的文件与您的系统架构（32 位或 64 位）相匹配，并确保来源的安全性‌

35 超级表带 TAG 过滤查子查数据与直接查子表哪个块？

直接查子表更快。超级表带 TAG 过滤查询子查数据是为满足查询方便性，同时可对多个子表中数据进行过滤，如果目的是追求性能并已明确查询子表，直接从子表查性能更高

36 如何查看数据库的数据压缩率和磁盘占用指标？

TDengine TSDB 3.3.5.0 之前的版本，只提供以表为统计单位的压缩率，数据库及整体还未提供，查看命令是在客户端 TDengine TSDB CLI 中执行 SHOW TABLE DISTRIBUTED table_name; 命令，table_name 为要查看压缩率的表，可以为超级表、普通表及子表，详细可查看此处

TDengine TSDB 3.3.5.0 及以上的版本，还提供了数据库整体压缩率和磁盘空间占用统计。查看数据库整体的数据压缩率和磁盘空间占用的命令为 SHOW db_name.disk_info;，查看数据库各个模块的磁盘空间占用的命令为 SELECT * FROM INFORMATION_SCHEMA.INS_DISK_USAGE WHERE db_name='db_name';，db_name 为要查看的数据库名称。详细可查看此处

37 短时间内，通过 systemd 重启 taosd 超过一定次数后重启失败，报错：start-limit-hit

问题描述： TDengine TSDB 3.3.5.1 及以上的版本，taosd.service 的 systemd 配置文件中，StartLimitInterval 参数从 60 秒调整为 900 秒。若在 900 秒内 taosd 服务重启达到 3 次，后续通过 systemd 启动 taosd 服务时会失败，执行 systemctl status taosd.service 显示错误：Failed with result 'start-limit-hit'。

问题原因： TDengine TSDB 3.3.5.1 之前的版本，StartLimitInterval 为 60 秒。若在 60 秒内无法完成 3 次重启（例如，因从 WAL（预写式日志）中恢复大量数据导致启动时间较长），则下一个 60 秒周期内的重启会重新计数，导致系统持续不断地重启 taosd 服务。为避免无限重启问题，将 StartLimitInterval 由 60 秒调整为 900 秒。因此，在使用 systemd 短时间内多次启动 taosd 时遇到 start-limit-hit 错误的机率增多。

问题解决： 1）通过 systemd 重启 taosd 服务：推荐方法是先执行命令 systemctl reset-failed taosd.service 重置失败计数器，然后再通过 systemctl restart taosd.service 重启；若需长期调整，可手动修改 /etc/systemd/system/taosd.service 文件，将 StartLimitInterval 调小或将 StartLimitBurst 调大 (注：重新安装 taosd 会重置该参数，需要重新修改)，执行 systemctl daemon-reload 重新加载配置，然后再重启。2）也可以不通过 systemd 而是通过 taosd 命令直接重启 taosd 服务，此时不受 StartLimitInterval 和 StartLimitBurst 参数限制。

38 我确认修改了配置文件中参数但并没有生效？

问题描述： TDengine TSDB 3.3.5.0 及以上的版本，有些用户可能会遇到一个问题：我在 taos.cfg 中修改了某个配置参数，但是重启后发现并没有生效，查看日志也找不到任何报错。

问题原因：这是由于 TDengine TSDB 3.3.5.0 及以上的版本支持将动态修改的配置参数持久化，也就是您通过 ALTER 动态修改的参数，重启后仍然生效。所以 TDengine TSDB 3.3.5.0 及以上的版本在重启时会默认从 dataDir 中加载除了 dataDir 之外的的配置参数，而不会使用 taos.cfg 中的配置参数。

问题解决：如果您了解了配置参数持久化的功能，仍然希望重启后从配置文件中加载配置参数，可以通过在配置文件中增加 forceReadConfig 1 这将会使 TDengine TSDB 强制从配置文件中读取配置参数。

39 数据库升级，从 2.6 升到 3.3，数据迁移同时业务还有数据在写入，会产生严重乱序吗？

这种情况通常不会产生乱序，首先我们来解释下 TDengine TSDB 中乱序是指什么？TDengine TSDB 中的乱序是指从时间戳为 0 开始按数据库设置的 Duration 参数（默认是 10 天）切割成时间窗口，在每个时间窗口中写入的数据不按顺序时间写入导致的现象为乱序现象，只要保证同一窗口是顺序写入的，即使窗口之间写入并非顺序，也不会产生乱序。

再看上面场景，补旧数据和新数据同时写入，新旧数据之间一般会存在较大距离，不会落在同一窗口中，只要保证新老数据都是顺序写的，即不会产生乱序现象。

问题反馈​

常见问题列表​

1. TDengine TSDB 3.0 之前的版本升级到 3.0 及以上的版本应该注意什么？​

2. Windows 平台下 JDBCDriver 找不到动态链接库，怎么办？​

3. 遇到加载libtaosnative.so或libtaosws.so失败怎么办？​

4. 如何让 TDengine TSDB crash 时生成 core 文件？​

5. 遇到错误 "Unable to establish connection" 怎么办？​

6. 遇到错误 "Unable to resolve FQDN" 怎么办？​

7. 最有效的写入数据的方法是什么？​

8. Windows 系统下插入的 nchar 类数据中的汉字被解析成了乱码如何解决？​

9. Windows 系统下客户端无法正常显示中文字符？​

10. 表名显示不全​

11. 如何进行数据迁移？​

12. 如何在命令行程序 taos 中临时调整日志级别​

13. go 语言编写组件编译失败怎样解决？​

14. 如何查询数据占用的存储空间大小？​

15. 客户端连接串如何保证高可用？​

16. 时间戳的时区信息是怎样处理的？​

17. TDengine TSDB 3.0 都会用到哪些网络端口？​

18. 为什么 RESTful 接口无响应、Grafana 无法添加 TDengine TSDB 为数据源、TDengine TSDB GUI 选了 6041 端口还是无法连接成功？​

19. 发生了 OOM 怎么办？​

20. 在 macOS 上遇到 Too many open files 怎么办？​

21 建库时提示 Out of dnodes 或者建表时提示 Vnodes exhausted​

22 在服务器上的使用 TDengine TSDB CLI 能查到指定时间段的数据，但在客户端机器上查不到？​

23 表名确认是存在的，但在写入或查询时返回表名不存在，什么原因？​

24 在 TDengine TSDB CLI 中查询，字段内容不能完全显示出来怎么办？​

25 使用 taosBenchmark 测试工具写入数据查询很快，为什么我写入的数据查询非常慢？​

26 我想统计下前后两条写入记录之间的时间差值是多少？​

27 遇到报错 "DND ERROR Version not compatible, client: 3000700, server: 3020300"​

28 修改 database 的 root 密码后，启动 taos 遇到报错 "failed to connect to server, reason: Authentication failure"​

29 修改 database 的 root 密码后，Grafana 监控插件 TDinsight 无数据展示​

30 遇到报错 "some vnode/qnode/mnode(s) out of service" 怎么办？​

31 为什么开源版 TDengine TSDB 的主进程会建立一个与公网的连接？​

32 第一次连接集群时遇到 "Sync leader is unreachable" 怎么办？​

33 同一台服务器，数据库的数据目录 dataDir 不变，为什么原有数据库丢失且集群 ID 发生了变化？​

34 Windows 平台运行 TDengine TSDB 出现丢失 MVCP1400.DLL 解决方法？​

35 超级表带 TAG 过滤查子查数据与直接查子表哪个块？​

36 如何查看数据库的数据压缩率和磁盘占用指标？​

37 短时间内，通过 systemd 重启 taosd 超过一定次数后重启失败，报错：start-limit-hit​

38 我确认修改了配置文件中参数但并没有生效？​

39 数据库升级，从 2.6 升到 3.3，数据迁移同时业务还有数据在写入，会产生严重乱序吗？​

支持和反馈