# 发行版本

版本 IoTDB 二进制包 IoTDB 源代码 发布说明
1.0.0 All-in-one SHA512 ASC 源代码 SHA512 ASC release notes
Grafana 插件 SHA512 ASC
0.13.3 All-in-one SHA512 ASC 源代码 SHA512 ASC release notes
Grafana 插件 SHA512 ASC
Grafana 连接器 SHA512 ASC

历史版本下载:https://archive.apache.org/dist/iotdb/ (opens new window)

# 环境配置

  • 推荐修改的操作系统参数
    • 将 somaxconn 设置为 65535 以避免系统在高负载时出现 "connection reset" 错误。
      # Linux
      > sudo sysctl -w net.core.somaxconn=65535
       
      # FreeBSD or Darwin
      > sudo sysctl -w kern.ipc.somaxconn=65535
      
      1
      2
      3
      4
      5

# 关于 Version 1.0

  • 如何从 v0.13.x 升级到 v1.0.x?

    • 1.0版本进行了 SQL 语法约定的改动(请参考用户手册语法约定章节),不兼容之处可以参考下方1.0 版本不兼容的语法详细说明
    • 为了保证 UDF 相关 API 的稳定性,1.0 版本中 UDF 相关 API 被独立为一个单独的 module,不再依赖 tsfile 包,已经实现的 UDF 需要改写代码,将 TsDataType 替换为 Type,将 org.apache.iotdb.tsfile.utils.Binary 替换成 org.apache.iotdb.udf.api.type.Binary,并重新进行打包装载流程。

# 1.0 版本不兼容的语法详细说明

在之前版本的语法约定中,为了保持兼容性,我们引入了一些会引起歧义的规定。为了避免歧义,我们设计了新的语法约定,本章将说明旧语法约定中存在的问题,以及我们做出改动的原因。

# 标识符限制增强

在0.13及之前版本中,不使用反引号引用的标识符(包括路径结点)允许为实数(实数路径名在 SELECT 子句中需要用反引号括起),且允许包含部分特殊字符,在 1.0 版本中,不使用反引号引用的标识符不允许为实数,不使用反引号引用的标识符,只允许包含字母、中文字符、下划线。

# 路径名使用的相关问题

在旧语法约定中,什么时候需要给路径结点名添加引号,用单双引号还是反引号的规则较为复杂,在新的语法约定中我们做了统一,具体可以参考本文档的相关章节。

# 单双引号和反引号的使用时机

在之前的语法约定中,路径结点名被定义成标识符,但是当需要在路径结点名中使用路径分隔符 . 时,需要使用单引号或者双引号引用。这与标识符使用反引号引用的规则相悖。

# 在之前的语法约定中,如果需要创建时间序列 root.sg.`www.baidu.com`,需要使用下述语句:
create root.sg.'www.baidu.com' with datatype=BOOLEAN, encoding=PLAIN

# 该语句创建的时间序列实际为 root.sg.'www.baidu.com',即引号一并存入,该时间序列的三个结点为{"root","sg","'www.baidu.com'"}

# 在查询语句中,如果希望查询该时间序列的数据,查询语句如下:
select 'www.baidu.com' from root.sg;
1
2
3
4
5
6
7

而在 1.0 版本的语法约定中,特殊路径结点名统一使用反引号引用:

# 在现有语法约定中,如果需要创建时间序列 root.sg.`www.baidu.com`,语法如下:
create root.sg.`www.baidu.com` with datatype = BOOLEAN, encoding = PLAIN

# 查询该时间序列可以通过如下语句:
select `www.baidu.com` from root.sg;
1
2
3
4
5
# 路径结点名内部使用引号的问题

在旧语法约定中,在路径结点名中使用单引号 ' 和 双引号 " 时,需要使用反斜杠 \ 进行转义,且反斜杠会被视为路径结点名的一部分存入,而在使用其它标识符时没有这个限制,造成了不统一。

# 创建时间序列 root.sg.\"a
create timeseries root.sg.`\"a` with datatype=TEXT,encoding=PLAIN;

# 查询时间序列 root.sg.\"a
select `\"a` from root.sg;
+-----------------------------+-----------+
|                         Time|root.sg.\"a|
+-----------------------------+-----------+
|1970-01-01T08:00:00.004+08:00|       test|
+-----------------------------+-----------+
1
2
3
4
5
6
7
8
9
10

在新语法约定中,特殊路径结点名统一使用反引号进行引用,在路径结点名中使用单双引号无须添加反斜杠转义,使用反引号需要双写,具体可以参考新语法约定路径结点名章节。

# Session 接口相关

# Session 接口语法限制

在0.13版本中,对于非SQL接口中使用路径结点的限制如下:

  • 经参数传入的路径或路径前缀中的节点:
    • 在 SQL 语句中需要使用反引号(`)进行转义的,此处均不需要进行转义。
    • 使用单引号或双引号括起的节点,仍需要使用单引号或双引号括起,并且要针对 JAVA 字符串进行反转义。
    • 对于 checkTimeseriesExists 接口,由于内部调用了 IoTDB-SQL 接口,因此需要和 SQL 语法规范保持一致,并且针对 JAVA 字符串进行反转义。

1.0 版本中,对非SQL接口中使用路径结点的限制增强:

  • 经参数传入的路径或路径前缀中的节点: 在 SQL 语句中需要使用反引号(`)进行转义的,均需要使用反引号进行转义。

  • 语法说明相关代码示例可以参考:example/session/src/main/java/org/apache/iotdb/SyntaxConventionRelatedExample.java

# SQL和Session接口对字符串反转义处理不一致

在之前版本中,使用字符串时,SQL 和 Session 接口存在不一致的情况。比如使用 SQL 插入 Text 类型数据时,会对字符串进行反转义处理,而使用 Session 接口时不会进行这样的处理,存在不一致。在新的语法约定中,我们统一不对字符串做反转义处理,存入什么内容,在查询时就会得到什么内容(字符串内部使用单双引号的规则可以参考本文档字符串常量章节)。

下面是旧语法约定中不一致的例子:

使用 Session 的 insertRecord 方法向时序 root.sg.a 中插入数据

// session 插入
String deviceId = "root.sg";
List<String> measurements = new ArrayList<>();
measurements.add("a");
String[] values = new String[]{"\\\\", "\\t", "\\\"", "\\u96d5"};
for(int i = 0; i <= values.length; i++){
  List<String> valueList = new ArrayList<>();
  valueList.add(values[i]);
  session.insertRecord(deviceId, i + 1, measurements, valueList);
  }
1
2
3
4
5
6
7
8
9
10

查询 root.sg.a 的数据,可以看到没有做反转义处理:

// 查询结果
+-----------------------------+---------+
|                         Time|root.sg.a|
+-----------------------------+---------+
|1970-01-01T08:00:00.001+08:00|       \\|
|1970-01-01T08:00:00.002+08:00|       \t|
|1970-01-01T08:00:00.003+08:00|       \"|
|1970-01-01T08:00:00.004+08:00|   \u96d5|
+-----------------------------+---------+
1
2
3
4
5
6
7
8
9

而使用 SQL 向 root.sg.a 中插入数据

# SQL 插入
insert into root.sg(time, a) values(1, "\\")
insert into root.sg(time, a) values(2, "\t")
insert into root.sg(time, a) values(3, "\"")
insert into root.sg(time, a) values(4, "\u96d5")
1
2
3
4
5

查询 root.sg.a 的数据,可以看到字符串进行了反转义:

// 查询结果
+-----------------------------+---------+
|                         Time|root.sg.a|
+-----------------------------+---------+
|1970-01-01T08:00:00.001+08:00|        \|
|1970-01-01T08:00:00.002+08:00|         |
|1970-01-01T08:00:00.003+08:00|        "|
|1970-01-01T08:00:00.004+08:00|       雕|
+-----------------------------+---------+
1
2
3
4
5
6
7
8
9

# 如何升级

  • 如何升级小版本 (例如,从 v0.12.4 to v0.12.5)?

    • 同一个大版本下的多个小版本是互相兼容的。
    • 只需要下载新的小版本, 然后修改其配置文件,使其与原有版本的设置一致。
    • 停掉旧版本进程,启动新版本即可。
  • 如何从 v0.12.x 升级到 v0.13.x?

    • 0.12 与 0.13 的数据文件格式兼容,但写前日志等格式不兼容,因此需要进行升级(但速度很快):
    • 在 0.12 的 CLI 中执行 SET SYSTEM TO READONLY 命令,并停止新数据的写入。
    • 在 CLI 执行 flush 命令,确保关闭所有的 TsFile 文件。
    • 我们推荐提前备份整个 data 目录,以备回滚。
    • 下载最新 0.13 版本,解压并修改配置文件,尤其是 时间戳精度等首次启动后不可修改的配置参数 。并将各数据目录都指向备份的或者 v0.12 原来使用的数据目录。
    • 停止 v0.12 的实例,启动 v0.13 的实例。
    • 执行上述步骤后, 请确认data/system/schema/system.properties文件中的 iotdb_version0.13.x. 如果不是,请手动修改为0.13.x
    • 注意:0.13 的配置文件进行了较大改动,因此不要直接将 0.12 的配置文件用于 0.13
    • 0.13 进行了 SQL 语法的改动,不使用反引号括起的标识符中仅能包含如下字符,否则需要使用反引号括起。
      • [0-9 a-z A-Z _ : @ # $ { }] (字母,数字,部分特殊字符)
      • ['\u2E80'..'\u9FFF'] (UNICODE 中文字符)
    • 0.13 中 SELECT 子句中路径结点名如果是实数,需要使用反引号引起,用于与表达式中的常数区分。如语句 "select 123 + `123` from root.sg",前一个123表示常数,后一个 `123`会和 root.sg 拼接,表示路径 root.sg.`123`。
  • 如何从 v0.11.x 或 v0.10.x 升级到 v0.12.x?

    • 从 0.11 或 0.10 升级到 0.12 的过程与 v0.9 升级到 v0.10 类似,升级工具会自动进行数据文件的升级。
    • 停掉旧版本新数据写入。
    • 用 CLI 调用flush,确保关闭所有的 TsFile 文件。
    • 我们推荐提前备份数据文件(以及写前日志和 mlog 文件),以备回滚。
    • 下载最新版,解压并修改配置文件。将各数据目录都指向备份的或者 v0.11 或 0.10 原来使用的数据目录。 把 0.11 中的其他修改都放到 0.12 中。
    • 停止旧版本 IoTDB 的实例,启动 v0.12 的实例。IoTDB 将后台自动升级数据文件格式。在升级过程中数据可以进行查询和写入。
      • 当日志中显示All files upgraded successfully! 后代表升级成功。
      • 注意 1:0.12 的配置文件进行了较大改动,因此不要直接将原本的配置文件用于 0.12
      • 注意 2: 由于 0.12 不支持从 0.9 或者更低版本升级,如果需要升级,请先升级到 0.10 版本
      • 注意 3: 在文件升级完成前,最好不要进行 delete 操作。如果删除某个 database 内的数据且该 database 内存在待升级文件,删除会失败。
  • 如何从 v0.10.x 升级到 v0.11.x?

    • 0.10 与 0.11 的数据文件格式兼容,但写前日志等格式不兼容,因此需要进行升级(但速度很快):
    • 停掉 0.10 的新数据写入。
    • 用 CLI 调用flush,确保关闭所有的 TsFile 文件。
    • 我们推荐提前备份写前日志和 mlog 文件,以备回滚。
    • 下载最新版,解压并修改配置文件。将各数据目录都指向备份的或者 v0.10 原来使用的数据目录。
    • 停止 v0.10 的实例,启动 v0.11 的实例。IoTDB 将自动升级不兼容的文件格式。
    • 注意:0.11 的配置文件进行了较大改动,因此不要直接将 0.10 的配置文件用于 0.11
  • 如何从 v0.9.x 升级到 v0.10.x?

    • 停掉旧版本新数据写入。
    • 用 CLI 调用flush,确保关闭所有的 TsFile 文件。
    • 我们推荐提前备份数据文件(以及写前日志和 mlog 文件),以备回滚。
    • 下载最新版,解压并修改配置文件。将各数据目录都指向备份的或者 v0.9 原来使用的数据目录。
    • 停止 v0.9 的实例,启动 v0.10 的实例。IoTDB 将自动升级数据文件格式。
  • 如何从 0.8.x 升级到 v0.9.x?

    • 我们推荐提前备份数据文件(以及写前日志和 mlog 文件),以备回滚。
    • 下载最新版,解压并修改配置文件。将各数据目录都指向备份的或者 v0.8 原来使用的数据目录。
    • 停止 v0.8 的实例,启动 v0.9.x 的实例。IoTDB 将自动升级数据文件格式。

# 所有版本

Archive repository (opens new window) 查看所有版本

# 验证哈希和签名

除了我们的发行版,我们还在 *.sha512 文件中提供了 sha512 散列,并在 *.asc 文件中提供了加密签名。 Apache Software Foundation 提供了广泛的教程来 验证哈希和签名 (opens new window),您可以使用任何这些发布签名的 KEYS (opens new window) 来遵循这些哈希和签名。

发现错误?在 GitHub 上编辑此页 (opens new window)

Copyright © 2022 The Apache Software Foundation.
Apache and the Apache feather logo are trademarks of The Apache Software Foundation

Have a question? Connect with us on QQ, WeChat, or Slack. Join the community now.

We use Google Analytics to collect anonymous, aggregated usage information.