常见问题

一般问题

1. 如何查询我的IoTDB版本？

有几种方法可以识别您使用的 IoTDB 版本：

  • 启动 IoTDB 的命令行界面：
  1. > ./start-cli.sh -p 6667 -pw root -u root -h localhost
  2.  _____       _________  ______   ______    
  3. |_   _|     |  _   _  ||_   _ `.|_   _ \   
  4.   | |   .--.|_/ | | \_|  | | `. \ | |_) |  
  5.   | | / .'`\ \  | |      | |  | | |  __'.  
  6.  _| |_| \__. | _| |_    _| |_.' /_| |__) | 
  7. |_____|'.__.' |_____|  |______.'|_______/  version x.x.x
  • 检查 pom.xml 文件：
  1. <version>x.x.x</version>
  • 使用 JDBC API:
  1. String iotdbVersion = tsfileDatabaseMetadata.getDatabaseProductVersion();
  • 使用命令行接口：
  1. IoTDB> show version
  2. show version
  3. +---------------+
  4. |version        |
  5. +---------------+
  6. |x.x.x          |
  7. +---------------+
  8. Total line number = 1
  9. It costs 0.241s

2. 在哪里可以找到IoTDB的日志？

假设您的根目录是：

  1. $ pwd
  2. /workspace/iotdb
  4. $ ls -l
  5. server/
  6. cli/
  7. pom.xml
  8. Readme.md
  9. ...

假如 $IOTDB_HOME = /workspace/iotdb/server/target/iotdb-server-{project.version}

假如 $IOTDB_CLI_HOME = /workspace/iotdb/cli/target/iotdb-cli-{project.version}

在默认的设置里，logs 文件夹会被存储在IOTDB_HOME/logs。您可以在IOTDB_HOME/conf目录下的logback.xml文件中修改日志的级别和日志的存储路径。

3. 在哪里可以找到IoTDB的数据文件？

在默认的设置里，数据文件（包含 TsFile，metadata，WAL）被存储在IOTDB_HOME/data/datanode文件夹。

4. 如何知道IoTDB中存储了多少时间序列？

使用 IoTDB 的命令行接口：

  1. IoTDB> show timeseries root

在返回的结果里，会展示Total timeseries number，这个数据就是 IoTDB 中 timeseries 的数量。

在当前版本中，IoTDB 支持直接使用命令行接口查询时间序列的数量：

  1. IoTDB> count timeseries root

如果您使用的是 Linux 操作系统，您可以使用以下的 Shell 命令：

  1. > grep "0,root" $IOTDB_HOME/data/system/schema/mlog.txt |  wc -l
  2. >   6

5. 可以使用Hadoop和Spark读取IoTDB中的TsFile吗？

是的。IoTDB 与开源生态紧密结合。IoTDB 支持 Hadoop常见问题 - 图1open in new window, Spark常见问题 - 图2open in new window 和 Grafana常见问题 - 图3open in new window 可视化工具。

6. IoTDB如何处理重复的数据点？

一个数据点是由一个完整的时间序列路径（例如：root.vehicle.d0.s0) 和时间戳唯一标识的。如果您使用与现有点相同的路径和时间戳提交一个新点，那么 IoTDB 将更新这个点的值，而不是插入一个新点。

7. 我如何知道具体的timeseries的类型？

在 IoTDB 的命令行接口中使用 SQL SHOW TIMESERIES <timeseries path>:

例如：如果您想知道所有 timeseries 的类型 <timeseries path> 应该为 root。上面的 SQL 应该修改为：

  1. IoTDB> show timeseries root

如果您想查询一个指定的时间序列，您可以修改 <timeseries path> 为时间序列的完整路径。比如：

  1. IoTDB> show timeseries root.fit.d1.s1

您还可以在 timeseries 路径中使用通配符：

  1. IoTDB> show timeseries root.fit.d1.*

8. 如何更改IoTDB的客户端时间显示格式？

IoTDB 客户端默认显示的时间是人类可读的（比如：1970-01-01T08:00:00.001)，如果您想显示是时间戳或者其他可读格式，请在启动命令上添加参数-disableISO8601:

  1. > $IOTDB_CLI_HOME/sbin/start-cli.sh -h 127.0.0.1 -p 6667 -u root -pw root -disableISO8601

9. 怎么处理来自org.apache.ratis.grpc.server.GrpcLogAppender的IndexOutOfBoundsException？

这是我们的依赖Ratis 2.4.1的一个内部错误日志，不会对数据写入和读取造成任何影响。
已经报告给Ratis社区，并会在未来的版本中修复。

分布式部署 FAQ

集群启停

1. ConfigNode初次启动失败，如何排查原因？

  • ConfigNode初次启动时确保已清空data/confignode目录
  • 确保该ConfigNode使用到的<IP+端口>没有被占用，没有与已启动的ConfigNode使用到的<IP+端口>冲突
  • 确保该ConfigNode的cn_target_confignode_list（指向存活的ConfigNode；如果该ConfigNode是启动的第一个ConfigNode，该值指向自身）配置正确
  • 确保该ConfigNode的配置项（共识协议、副本数等）等与cn_target_confignode_list对应的ConfigNode集群一致

2. ConfigNode初次启动成功，show cluster的结果里为何没有该节点？

  • 检查cn_target_confignode_list是否正确指向了正确的地址； 如果cn_target_confignode_list指向了自身，则会启动一个新的ConfigNode集群

3. DataNode初次启动失败，如何排查原因？

  • DataNode初次启动时确保已清空data/datanode目录。 如果启动结果为“Reject DataNode restart.”则表示启动时可能没有清空data/datanode目录
  • 确保该DataNode使用到的<IP+端口>没有被占用，没有与已启动的DataNode使用到的<IP+端口>冲突
  • 确保该DataNode的dn_target_confignode_list指向存活的ConfigNode

4. 移除DataNode执行失败，如何排查？

  • 检查remove-datanode脚本的参数是否正确，是否传入了正确的ip:port或正确的dataNodeId
  • 只有集群可用节点数量 > max(元数据副本数量, 数据副本数量)时，移除操作才允许被执行
  • 执行移除DataNode的过程会将该DataNode上的数据迁移到其他存活的DataNode，数据迁移以Region为粒度，如果某个Region迁移失败，则被移除的DataNode会一直处于Removing状态
  • 补充：处于Removing状态的节点，其节点上的Region也是Removing或Unknown状态，即不可用状态。 该Remvoing状态的节点也不会接受客户端的请求。如果要使Removing状态的节点变为可用，用户可以使用set system status to running 命令将该节点设置为Running状态；如果要使迁移失败的Region处于可用状态，可以使用migrate region from datanodeId1 to datanodeId2 命令将该不可用的Region迁移到其他存活的节点。另外IoTDB后续也会提供remove-datanode.sh常见问题 - 图4open in new window -f命令，来强制移除节点（迁移失败的Region会直接丢弃）

5. 挂掉的DataNode是否支持移除？

  • 当前集群副本数量大于1时可以移除。 如果集群副本数量等于1，则不支持移除。 在下个版本会推出强制移除的命令

6. 从0.13升级到1.0需要注意什么？

  • 0.13版本与1.0版本的文件目录结构是不同的，不能将0.13的data目录直接拷贝到1.0集群使用。如果需要将0.13的数据导入至1.0，可以使用LOAD功能
  • 0.13版本的默认RPC地址是0.0.0.0，1.0版本的默认RPC地址是127.0.0.1

集群重启

1. 如何重启集群中的某个ConfigNode？

  • 第一步：通过stop-confignode.sh或kill进程方式关闭ConfigNode进程
  • 第二步：通过执行start-confignode.sh启动ConfigNode进程实现重启
  • 下个版本IoTDB会提供一键重启的操作

2. 如何重启集群中的某个DataNode？

  • 第一步：通过stop-datanode.sh或kill进程方式关闭DataNode进程
  • 第二步：通过执行start-datanode.sh启动DataNode进程实现重启
  • 下个版本IoTDB会提供一键重启的操作

3. 将某个ConfigNode移除后（remove-confignode），能否再利用该ConfigNode的data目录重启？

  • 不能。会报错：Reject ConfigNode restart. Because there are no corresponding ConfigNode(whose nodeId=xx) in the cluster.

4. 将某个DataNode移除后（remove-datanode），能否再利用该DataNode的data目录重启？

  • 不能正常重启，启动结果为“Reject DataNode restart. Because there are no corresponding DataNode(whose nodeId=xx) in the cluster. Possible solutions are as follows:…”

5. 用户看到某个ConfigNode/DataNode变成了Unknown状态，在没有kill对应进程的情况下，直接删除掉ConfigNode/DataNode对应的data目录，然后执行start-confignode.sh/start-datanode.sh，这种情况下能成功吗常见问题 - 图5open in new window?

  • 无法启动成功，会报错端口已被占用

集群运维

1. Show cluster执行失败，显示“please check server status”，如何排查?

  • 确保ConfigNode集群一半以上的节点处于存活状态
  • 确保客户端连接的DataNode处于存活状态

2. 某一DataNode节点的磁盘文件损坏，如何修复这个节点?

  • 当前只能通过remove-datanode的方式进行实现。remove-datanode执行的过程中会将该DataNode上的数据迁移至其他存活的DataNode节点（前提是集群设置的副本数大于1）
  • 下个版本IoTDB会提供一键修复节点的功能

3. 如何降低ConfigNode、DataNode使用的内存？

  • 在conf/confignode-env.sh、conf/datanode-env.sh文件可通过调整MAX_HEAP_SIZE、MAX_DIRECT_MEMORY_SIZE等选项可以调整ConfigNode、DataNode使用的最大堆内、堆外内存