跳到主要内容
KWDB 开发者专区

KWDB 时序数据库教程

KWDB 是 KaiwuDB 的开源版本，也是由开放原子开源基金会（OpenAtom Foundation）孵化的开源分布式多模数据库产品。它面向 AIoT 场景提供时序数据处理能力，适合存储设备指标、传感器读数、能耗曲线、车联网状态和运维监控数据，并通过 SQL 将这些数据与关系维表关联起来。

时序数据在 KWDB 中如何组织​

典型的时序数据包含两类信息：

  • 时间和值：例如温度、湿度、电压、电流、位置或状态。
  • 标签和维度：例如设备 ID、站点、区域、型号、租户或业务线。

在 KWDB 中，你可以创建时序数据库和带标签的时序表，再用标签表达设备维度。

CREATE TS DATABASE sensor_data;

CREATE TABLE sensor_data.readings (
  ts TIMESTAMPTZ NOT NULL,
  temperature FLOAT,
  humidity FLOAT
) TAGS (
  device_id INT NOT NULL,
  location VARCHAR(256) NOT NULL
) PRIMARY TAGS(device_id);

为什么时序数据还需要关系数据​

设备读数本身通常不够回答业务问题。你还需要设备名称、安装日期、区域、负责人和告警规则等关系数据。KWDB 的价值在于让时序数据和关系数据在同一套 SQL 工作流中被查询。

你可以在 5 分钟快速体验 KWDB 中看到完整的建表、写入和跨模查询示例。

常见查询场景​

  • 查询某个设备在指定时间范围内的最新指标。
  • 按站点或区域聚合传感器数据。
  • 将设备读数与设备档案表关联。
  • 基于窗口函数分析能耗趋势。
  • 对异常指标生成巡检或诊断输入。

下一步​