系统环境需求

安装 IoTDB：参考 快速上手 (opens new window). 假设 IoTDB 安装在 $IoTDB_HOME.

安装 Zeppelin：

假设 Zeppelin 安装在 $Zeppelin_HOME.

编译解释器

运行如下命令编译 IoTDB Zeppelin 解释器。

$IoTDB_HOME/zeppelin-interpreter/target/zeppelin-{version}-SNAPSHOT-jar-with-dependencies.jar

安装解释器

当你编译好了解释器，在 Zeppelin 的解释器目录下创建一个新的文件夹iotdb，并将 IoTDB 解释器放入其中。

启动 Zeppelin 和 IoTDB

进入 $Zeppelin_HOME 并运行 Zeppelin：

# Unix/OS X
> ./bin/zeppelin-daemon.sh start
# Windows

进入 $IoTDB_HOME 并运行 IoTDB：

当 Zeppelin 启动后，访问 http://127.0.0.1:8080/ (opens new window)

通过如下步骤创建一个新的笔记本页面：

1. 点击 Create new node 按钮
2. 设置笔记本名
3. 选择解释器为 iotdb

现在可以开始使用 Zeppelin 操作 IoTDB 了。

SET STORAGE GROUP TO root.ln.wf01.wt01;
CREATE TIMESERIES root.ln.wf01.wt01.status WITH DATATYPE=BOOLEAN, ENCODING=PLAIN;
CREATE TIMESERIES root.ln.wf01.wt01.temperature WITH DATATYPE=FLOAT, ENCODING=PLAIN;
CREATE TIMESERIES root.ln.wf01.wt01.hardware WITH DATATYPE=INT32, ENCODING=PLAIN;
INSERT INTO root.ln.wf01.wt01 (timestamp, temperature, status, hardware)
VALUES (1, 1.1, false, 11);
INSERT INTO root.ln.wf01.wt01 (timestamp, temperature, status, hardware)
VALUES (2, 2.2, true, 22);
INSERT INTO root.ln.wf01.wt01 (timestamp, temperature, status, hardware)
VALUES (3, 3.3, false, 33);
INSERT INTO root.ln.wf01.wt01 (timestamp, temperature, status, hardware)
VALUES (4, 4.4, false, 44);
INSERT INTO root.ln.wf01.wt01 (timestamp, temperature, status, hardware)
VALUES (5, 5.5, false, 55);
SELECT *
FROM root.ln.wf01.wt01
WHERE time >= 1

样例如下：

用户也可以参考 编写更丰富多彩的文档。

以上样例放置于 $IoTDB_HOME/zeppelin-interpreter/Zeppelin-IoTDB-Demo.zpln

进入页面 http://127.0.0.1:8080/#/interpreter (opens new window) 并配置 IoTDB 的连接参数：

可配置参数默认值和解释如下：