IoTDB 从零入门：安装部署、基础配置与数据写入实操

时序数据正在成为物联网、工业互联网、车联网等领域的核心数据资产。
如何高效管理海量带时间戳的数据？Apache IoTDB 给出了答案。
本文面向零基础读者，带你从下载到运行，完成第一次数据写入，全程动手实操。

1. IoTDB 是什么？

• 专为时序数据设计的 Apache 顶级开源数据库

• 核心特点：高压缩比、高性能写入/查询、类 SQL 语法、轻量级

• 适用场景：工业监控、智能工厂、新能源、车联网

2. 环境准备

• 操作系统：Windows / Linux / macOS 均可（本文以 Linux 为例）

• 依赖：JDK 17+（必需）

• 下载地址：Apache 官方镜像或 GitHub Releases

打开终端命令窗口，输入命令检查java版本

# 检查 Java 版本 
java -version

3. 下载与安装

Index of /iotdb/2.0.8

直接输入这个网址进行下载，然后解压

4. 目录结构速览

5. 启动并连接 IoTDB（单机模式）

可以打开sbin目录文件

①Windows演示

启动成功之后来启动数据库

这样子数据库就启动成功啦

如果双击运行提示，就右键属性勾选

②Docker演示

首先，一样要检查，jdk是否存在，不存在则安装

然后可以在服务器上创建专门放置iotdb的文件夹

mkdir iotdb

用scp【Secure Copy（安全复制）】指令把文件夹上传到服务器上去

scp /本地/文件.zip root@192.168.1.100:/远程/目录/

eg：scp D:\temp\timechodb-2.0.10.1.zip root@192.168.1.100:/iotdb

上传完成之后，进入iotdb目录，ls指令，查看是否上传成功

cd /iotdb

ls

然后解压  unzip 压缩包名称

解压成功之后

进入sbin目录 启动 datanode和confignode

./start-standalone.sh  

这个指令脚本就是一起把datanode 和 confignode起来的

然后可以看看是否启动成功

JPS指令，能看见datanode和confignode的进程，就说明启动成功

然后启动iotdb

 ./start-cli.sh

6. 第一个时序数据写入

6.1 基础概念速懂（存储组 → 路径 → 测点）

• 存储组：root.ln（如：辽宁风电场）

• 设备：root.ln.wf01（风机 01）

• 测点：root.ln.wf01.temperature、root.ln.wf01.speed

6.2 创建存储组与时间序列

sql

CREATE STORAGE GROUP root.ln;
CREATE TIMESERIES root.ln.wf01.temperature WITH DATATYPE=FLOAT, ENCODING=RLE;
CREATE TIMESERIES root.ln.wf01.speed WITH DATATYPE=FLOAT, ENCODING=RLE;

6.3 插入数据（INSERT）

sql

INSERT INTO root.ln.wf01(timestamp, temperature, speed) VALUES (now(), 23.5, 6.2);
INSERT INTO root.ln.wf01(timestamp, temperature, speed) VALUES (2026-07-16T10:00:00, 24.1, 5.8);

6.4 查询验证

sql

SELECT temperature, speed FROM root.ln.wf01 WHERE time >= 2026-07-16T00:00:00;

恭喜你！你已经完成了 IoTDB 从安装到写入的全流程。
时序数据库的门槛并不高，关键在动手。
如果在实践中遇到问题，欢迎在评论区留言，我会尽力协助。