IoTDB 常见问题 Q&A 第一期

IoTDB常见问题及解决方案汇总

最新推荐文章于 2025-03-21 17:41:06 发布

原创

最新推荐文章于 2025-03-21 17:41:06 发布 · 1.9k 阅读

30 ·

CC 4.0 BY-SA版权

文章标签：

#iotdb #数据库 #大数据

开始！关于 IoTDB 的 Q&A

我们将定期汇总社区讨论频繁的问题，并展开进行详细回答，通过积累常见问题“小百科”，方便大家使用 IoTDB。

Q1：WAL 堆积导致写入失败

问题及现象

集群报错：

The write is rejected because the wal directory size has reached the threshold 53687091200 bytes. You may need to adjust the flush policy of the storage storageengine or the IoTConsensus synchronization parameter`

原因及方案

1.1.0 及之前版本重启可能会导致 WAL 出现堆积，出现该现象时建议升级到当前最新版本 1.3.3。

在 1.3.3 版本如果依然出现该问题，可能有以下排查思路：

- 节点状态异常：执行 show cluster 或者 show cluster details 查看各个节点状态是否有 Unknown 或者 ReadOnly 状态。如果有则查看具体日志，针对出现问题的原因进行解决。

- 节点写入负载过大导致副本同步速度不够：如果在日志中发现存在共识组的 searchIndex 和 safeIndex 相差较多，可以尝试调整副本同步流水线并发阈值 data_region_iot_max_pending_batches_num 为 1 来提高同步效率。

内存较大 / Region 数较多/ 时间分区较多：可以手动执行 flush 命令将 memtable 刷盘，之后堆积的 WAL 即可被删除。如果未来依然会堆积报错，可以手动调整 iotdb-common.properities 中的 iot_consensus_throttle_threshold_in_byte 从 5