运维命令

FLUSH

将指定存储组的内存缓存区 Memory Table 的数据持久化到磁盘上，并将数据文件封口。

注意：此命令客户端不需要手动调用，IoTDB 有 wal 保证数据安全，IoTDB 会选择合适的时机进行 flush。 如果频繁调用 flush 会导致数据文件很小，降低查询性能。

  1. IoTDB> FLUSH 
  2. IoTDB> FLUSH root.ln
  3. IoTDB> FLUSH root.sg1,root.sg2

MERGE

触发层级合并和乱序合并。当前 IoTDB 支持使用如下两种 SQL 手动触发数据文件的合并：

  • MERGE 先触发层级合并，等层级合并执行完后，再触发乱序合并。在乱序合并中，仅重写重复的 Chunk，整理速度快，但是最终磁盘会存在多余数据。
  • FULL MERGE 先触发层级合并，等层级合并执行完后，再触发乱序合并。在乱序合并中，将需要合并的顺序和乱序文件的所有数据都重新写一份，整理速度慢，最终磁盘将不存在无用的数据。
  1. IoTDB> MERGE
  2. IoTDB> FULL MERGE

CLEAR CACHE

手动清除chunk, chunk metadata和timeseries metadata的缓存，在内存资源紧张时，可以通过此命令，释放查询时缓存所占的内存空间。

  1. IoTDB> CLEAR CACHE

SET STSTEM TO READONLY / WRITABLE

手动设置系统为只读或者可写入模式。

  1. IoTDB> SET SYSTEM TO READONLY
  2. IoTDB> SET SYSTEM TO WRITABLE

SCHEMA SNAPSHOT

为了加快 IoTDB 重启速度，用户可以手动触发创建 schema 的快照，从而避免服务器从 mlog 文件中恢复。此功能不支持使用模板、标签或对齐序列的场景。

  1. IoTDB> CREATE SNAPSHOT FOR SCHEMA

超时

IoTDB 支持 Session 超时和查询超时。

Session 超时

Session 超时控制何时关闭空闲 Session。空闲 Session 指在一段时间内没有发起任何操作的 Session。

Session 超时默认未开启。可以在配置文件中通过 session_timeout_threshold 参数进行配置。

查询超时

对于执行时间过长的查询，IoTDB 将强行中断该查询，并抛出超时异常，如下所示：

  1. IoTDB> select * from root;
  2. Msg: 701 Current query is time out, please check your statement or modify timeout parameter.

系统默认的超时时间为 60000 ms，可以在配置文件中通过 query_timeout_threshold 参数进行自定义配置。

如果您使用 JDBC 或 Session，还支持对单个查询设置超时时间（单位为 ms）：

  1. ((IoTDBStatement) statement).executeQuery(String sql, long timeoutInMS)
  2. session.executeQueryStatement(String sql, long timeout)

如果不配置超时时间参数或将超时时间设置为负数，将使用服务器端默认的超时时间。 如果超时时间设置为0，则会禁用超时功能。

查询中止

除了被动地等待查询超时外，IoTDB 还支持主动地中止查询，命令为：

  1. KILL QUERY <queryId>

通过指定 queryId 可以中止指定的查询，而如果不指定 queryId，将中止所有正在执行的查询。

为了获取正在执行的查询 id，用户可以使用 show query processlist 命令，该命令将显示所有正在执行的查询列表，结果形式如下：

TimequeryIdstatement

其中 statement 最大显示长度为 64 字符。对于超过 64 字符的查询语句，将截取部分进行显示。