本文将介绍关于 IoTDB 使用的基本流程,如果需要更多信息,请浏览我们官网的指引

安装环境

安装前需要保证设备上配有 JDK>=1.8 的运行环境,并配置好 JAVA_HOME 环境变量。

设置最大文件打开数为 65535。

安装步骤

IoTDB 支持多种安装途径。用户可以使用三种方式对 IoTDB 进行安装——下载二进制可运行程序、使用源码、使用 docker 镜像。

● 使用源码:您可以从代码仓库下载源码并编译,具体编译方法见下方。

● 二进制可运行程序:请从 下载 (opens new window)页面下载最新的安装包,解压后即完成安装。

● 使用 Docker 镜像:dockerfile 文件位于 https://github.com/apache/iotdb/blob/master/docker/src/main

软件目录结构

● sbin 启动和停止脚本目录
● conf 配置文件目录
● tools 系统工具目录
● lib 依赖包目录

IoTDB 试用

用户可以根据以下操作对 IoTDB 进行简单的试用,若以下操作均无误,则说明 IoTDB 安装成功。

启动 IoTDB

用户可以使用 sbin 文件夹下的 start-server 脚本启动 IoTDB。

Linux 系统与 MacOS 系统启动命令如下:

Windows 系统启动命令如下:

● "-c" and "-rpc_port" 都是可选的。
● 选项 "-c" 指定了配置文件所在的文件夹。
● 选项 "-rpc_port" 指定了启动的 rpc port。
● 如果两个选项同时指定,那么* rpc_port 将会覆盖 conf_path *下面的配置。

使用 Cli 工具

IoTDB 为用户提供多种与服务器交互的方式,在此我们介绍使用 Cli 工具进行写入、查询数据的基本步骤。

初始安装后的 IoTDB 中有一个默认用户:root,默认密码为 root。用户可以使用该用户运行 Cli 工具操作 IoTDB。Cli 工具启动脚本为 sbin 文件夹下的 start-cli 脚本。启动脚本时需要指定运行 ip、port、username 和 password。若脚本未给定对应参数,则默认参数为"-h 127.0.0.1 -p 6667 -u root -pw -root"

以下启动语句为服务器在本机运行,且用户未更改运行端口号的示例。

Linux 系统与 MacOS 系统启动命令如下:

Windows 系统启动命令如下:

启动后出现如图提示即为启动成功。

IoTDB 的基本操作

在这里,我们首先介绍一下使用 Cli 工具创建时间序列、插入数据并查看数据的方法。

数据在 IoTDB 中的组织形式是以时间序列为单位,每一个时间序列中有若干个数据-时间点对,每一个时间序列属于一个存储组。在定义时间序列之前,要首先使用 SET STORAGE GROUP 语句定义存储组。SQL 语句如下:

我们可以使用 SHOW STORAGE GROUP 语句来查看系统当前所有的存储组,SQL 语句如下:

执行结果为:

基础配置

配置文件在"conf"文件夹下,包括:

● "环境配置模块 (iotdb-env.bat, iotdb-env.sh),
● 选系统配置模块 (iotdb-engine.properties)
● 选日志配置模块 (logback.xml).