Google Git
Sign in
apache/iotdb-docs/refs/heads/remove_unused_docs/./src/zh/Download/README.md
blob: cbe1fcfd02ddd079a9b218b4ced73cad5b907bc6 [file] [view]
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
-->
# 发行版本
<table>
<tbody>
<tr>
<th>版本</th>
<th colspan="3">IoTDB 二进制包</th>
<th colspan="3">IoTDB 源代码</th>
<th>发布说明</th>
</tr>
<tr>
<td rowspan="2">2.0.8</td>
<td>
<a
href="https://www.apache.org/dyn/closer.cgi/iotdb/2.0.8/apache-iotdb-2.0.8-all-bin.zip"
>All-in-one</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/2.0.8/apache-iotdb-2.0.8-all-bin.zip.sha512"
>SHA512</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/2.0.8/apache-iotdb-2.0.8-all-bin.zip.asc"
>ASC</a
>
</td>
<td rowspan="2">
<a
href="https://www.apache.org/dyn/closer.cgi/iotdb/2.0.8/apache-iotdb-2.0.8-source-release.zip"
>源代码</a
>
</td>
<td rowspan="2">
<a
href="https://downloads.apache.org/iotdb/2.0.8/apache-iotdb-2.0.8-source-release.zip.sha512"
>SHA512</a
>
</td>
<td rowspan="2">
<a
href="https://downloads.apache.org/iotdb/2.0.8/apache-iotdb-2.0.8-source-release.zip.asc"
>ASC</a
>
</td>
<td rowspan="2">
<a href="https://downloads.apache.org/iotdb/2.0.8/RELEASE_NOTES.md"
>release notes</a
>
</td>
</tr>
<tr>
<td>
<a
href="https://www.apache.org/dyn/closer.cgi/iotdb/2.0.8/apache-iotdb-2.0.8-ainode-bin-manylinux-arm.zip"
>AINode linux-aarch64</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/2.0.8/apache-iotdb-2.0.8-ainode-bin-manylinux-arm.zip.sha512"
>SHA512</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/2.0.8/apache-iotdb-2.0.8-ainode-bin-manylinux-arm.zip.asc"
>ASC</a
>
</td>
</tr>
<tr>
<td rowspan="1">1.3.7</td>
<td>
<a
href="https://www.apache.org/dyn/closer.cgi/iotdb/1.3.7/apache-iotdb-1.3.7-all-bin.zip"
>All-in-one</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/1.3.7/apache-iotdb-1.3.7-all-bin.zip.sha512"
>SHA512</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/1.3.7/apache-iotdb-1.3.7-all-bin.zip.asc"
>ASC</a
>
</td>
<td rowspan="1">
<a
href="https://www.apache.org/dyn/closer.cgi/iotdb/1.3.7/apache-iotdb-1.3.7-source-release.zip"
>源代码</a
>
</td>
<td rowspan="1">
<a
href="https://downloads.apache.org/iotdb/1.3.7/apache-iotdb-1.3.7-source-release.zip.sha512"
>SHA512</a
>
</td>
<td rowspan="1">
<a
href="https://downloads.apache.org/iotdb/1.3.7/apache-iotdb-1.3.7-source-release.zip.asc"
>ASC</a
>
</td>
<td rowspan="1">
<a href="https://downloads.apache.org/iotdb/1.3.7/RELEASE_NOTES.md"
>release notes</a
>
</td>
</tr>
<tr>
<td rowspan="3">0.13.4</td>
<td>
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-all-bin.zip"
>All-in-one</a
>
</td>
<td>
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-all-bin.zip.sha512"
>SHA512</a
>
</td>
<td>
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-all-bin.zip.asc"
>ASC</a
>
</td>
<td rowspan="3">
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-source-release.zip"
>源代码</a
>
</td>
<td rowspan="3">
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-source-release.zip.sha512"
>SHA512</a
>
</td>
<td rowspan="3">
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-source-release.zip.asc"
>ASC</a
>
</td>
<td rowspan="3">
<a href="https://archive.apache.org/dist/iotdb/0.13.4/RELEASE_NOTES.md"
>release notes</a
>
</td>
</tr>
<tr>
<td>
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-grafana-connector-bin.zip"
>Grafana 连接器</a
>
</td>
<td>
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-grafana-connector-bin.zip.sha512"
>SHA512</a
>
</td>
<td>
<a
href="https://dlcdn.apache.org/iotdb/0.13.4/apache-iotdb-0.13.4-grafana-connector-bin.zip.asc"
>ASC</a
>
</td>
</tr>
<tr>
<td>
<a
href="https://www.apache.org/dyn/closer.cgi/iotdb/0.13.3/apache-iotdb-0.13.3-grafana-plugin-bin.zip"
>Grafana 插件</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/0.13.3/apache-iotdb-0.13.3-grafana-plugin-bin.zip.sha512"
>SHA512</a
>
</td>
<td>
<a
href="https://downloads.apache.org/iotdb/0.13.3/apache-iotdb-0.13.3-grafana-plugin-bin.zip.asc"
>ASC</a
>
</td>
</tr>
</tbody>
</table>
历史版本下载：[https://archive.apache.org/dist/iotdb/](https://archive.apache.org/dist/iotdb/)
## 环境配置
- 推荐修改的操作系统参数
- 将 somaxconn 设置为 65535 以避免系统在高负载时出现 "connection reset" 错误。
```bash
# Linux
> sudo sysctl -w net.core.somaxconn=65535
# FreeBSD or Darwin
> sudo sysctl -w kern.ipc.somaxconn=65535
```
## 关于 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 版本中，不使用反引号引用的标识符不允许为实数，不使用反引号引用的标识符，只允许包含字母、中文字符、下划线。**
#### 路径名使用的相关问题
在旧语法约定中，什么时候需要给路径结点名添加引号，用单双引号还是反引号的规则较为复杂，在新的语法约定中我们做了统一，具体可以参考本文档的相关章节。
##### 单双引号和反引号的使用时机
在之前的语法约定中，路径结点名被定义成标识符，但是当需要在路径结点名中使用路径分隔符 . 时，需要使用单引号或者双引号引用。这与标识符使用反引号引用的规则相悖。
```sql
# 在之前的语法约定中，如果需要创建时间序列 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.0 版本的语法约定中，特殊路径结点名统一使用反引号引用：**
```sql
# 在现有语法约定中，如果需要创建时间序列 root.sg.`www.baidu.com`，语法如下：
create root.sg.`www.baidu.com` with datatype = BOOLEAN, encoding = PLAIN
# 查询该时间序列可以通过如下语句：
select `www.baidu.com` from root.sg;
```
##### 路径结点名内部使用引号的问题
在旧语法约定中，在路径结点名中使用单引号 ' 和 双引号 " 时，需要使用反斜杠 \ 进行转义，且反斜杠会被视为路径结点名的一部分存入，而在使用其它标识符时没有这个限制，造成了不统一。
```sql
# 创建时间序列 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|
+-----------------------------+-----------+
```
**在新语法约定中，特殊路径结点名统一使用反引号进行引用**，在路径结点名中使用单双引号无须添加反斜杠转义，使用反引号需要双写，具体可以参考新语法约定路径结点名章节。
#### 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` 中插入数据
```Java
// 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);
}
```
查询 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|
+-----------------------------+---------+
```
而使用 SQL 向 root.sg.a 中插入数据
```sql
# 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")
```
查询 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| 雕|
+-----------------------------+---------+
```
# 如何升级
- 如何升级小版本 （例如，从 v0.12.4 to v0.12.5)?
- 同一个大版本下的多个小版本是互相兼容的。
- 只需要下载新的小版本， 然后修改其配置文件，使其与原有版本的设置一致。
- 停掉旧版本进程，启动新版本即可。
- 如何从 v0.13.x 升级到 v1.0.x？
- 0.13 版本与 1.0 版本的文件目录结构不同，**<span style="color:red">不能将 0.13 的 data 目录直接拷贝到 1.0 集群使用</span>**。如果需要将 0.13 的数据导入至 1.0，可以使用 [LOAD](../UserGuide/latest/Tools-System/Data-Import-Tool_apache) 功能;
- **0.13 版本的默认 RPC 地址是 0.0.0.0，1.0 版本的默认 RPC 地址是 127.0.0.1**
- 如何从 v1.0.0 升级到 v1.x.0？
- 停止写入，下载新版本文件，将 lib 文件夹全部替换，重启即可
- 如何从 v0.12.x 升级到 v0.13.x?
- 0.12 与 0.13 的数据文件格式兼容，但写前日志等格式不兼容，因此需要进行升级（但速度很快）：
- **<span style="color:red">在 0.12 的 CLI 中执行 `SET SYSTEM TO READONLY` 命令，并停止新数据的写入。</span>**
- 在 CLI 执行 `flush` 命令，确保关闭所有的 TsFile 文件。
- 我们推荐提前备份整个 data 目录，以备回滚。
- 下载最新 0.13 版本，解压并修改配置文件，尤其是 **<span style="color:red">时间戳精度等首次启动后不可修改的配置参数 </span>**。并将各数据目录都指向备份的或者 v0.12 原来使用的数据目录。
- 停止 v0.12 的实例，启动 v0.13 的实例。
- **<span style="color:red">执行上述步骤后, 请确认`data/system/schema/system.properties`文件中的 `iotdb_version` 是 `0.13.x`.
如果不是，请手动修改为`0.13.x`。</span>**
- **注意：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 类似，升级工具会自动进行数据文件的升级。
- **<span style="color:red">停掉旧版本新数据写入。</span>**
- 用 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 的数据文件格式兼容，但写前日志等格式不兼容，因此需要进行升级（但速度很快）：
- **<span style="color:red">停掉 0.10 的新数据写入。</span>**
- 用 CLI 调用`flush`，确保关闭所有的 TsFile 文件。
- 我们推荐提前备份写前日志和 mlog 文件，以备回滚。
- 下载最新版，解压并修改配置文件。将各数据目录都指向备份的或者 v0.10 原来使用的数据目录。
- 停止 v0.10 的实例，启动 v0.11 的实例。IoTDB 将自动升级不兼容的文件格式。
- **注意：0.11 的配置文件进行了较大改动，因此不要直接将 0.10 的配置文件用于 0.11**
- 如何从 v0.9.x 升级到 v0.10.x?
- **<span style="color:red">停掉旧版本新数据写入。</span>**
- 用 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](https://archive.apache.org/dist/iotdb/) 查看所有版本
# 验证哈希和签名
除了我们的发行版，我们还在 `*.sha512` 文件中提供了 sha512 散列，并在 `*.asc` 文件中提供了加密签名。 Apache Software Foundation 提供了广泛的教程来 [验证哈希和签名](http://www.apache.org/info/verification.html)，您可以使用任何这些发布签名的 [KEYS](https://downloads.apache.org/iotdb/KEYS) 来遵循这些哈希和签名。