跳转到主要内容
KWDB/SampleDB 示例项目

SimpleDB: 快速验证 KWDB 能力

你可以直接运行智能电表、跨模查询、窗口函数和聚合函数示例,快速验证 KWDB 在 AIoT 场景下的建模与查询能力。

克隆仓库
git clone https://github.com/KWDB/SampleDB.git
sampledb-quickstart
快速开始
项目内置 Agent Skill,可通过提示词引导完成验证
也可直接运行目录脚本,快速体验 SampleDB 示例
推荐提示词
帮我根据当前环境体验 SampleDB,并解释每一步在做什么。

四组可运行示例

每组示例都给出数据生成、建库建表、导入和查询脚本。已经以容器方式部署的 KWDB 可以直接开始体验。

建议先跑智能电表或跨模查询,再按需要延伸到窗口函数和聚合函数。

AIoT 数据建模

智能电表模型

基于智能电表业务组织关系库 rdb 与时序库 tsdb,覆盖用电量排行、故障电表、告警检测、负荷统计和最近 24 小时趋势查询。

关系 + 时序联合分析

跨模查询

在同一条查询中联合关系数据与时序数据,展示跨模统计信息和代价估算融合、跨模聚合下推与高速跨模连接算子。

分组窗口查询

窗口函数

覆盖 COUNT_WINDOW、EVENT_WINDOW、SESSION_WINDOW、STATE_WINDOW 和 TIME_WINDOW 五类窗口模型,适合验证时序事件边界。

时序聚合算子

聚合函数

覆盖 COUNT、AVG、SUM、MIN、MAX、STDDEV、FIRST、LAST、TWA 和 TIME_BUCKET 等典型聚合函数模型。

Smart Meter Web 智能电表数据可视化界面
来源: KWDB/SampleDB 的 smart-meter-web 示例

核心功能

  • 通过交互式仪表板可视化智能电表数据
  • 使用 SQL 查询接口查询电表信息
  • 管理电表读数和分析数据
  • 支持 Docker 容器化部署,兼容多种处理器架构

智能电表数据管理与可视化演示

Smart Meter Web 是基于 KWDB 多模数据库的智能电表数据管理和可视化演示系统,展示了 KWDB 在智能电表场景下的实际应用。

Docker 快速体验

使用 Docker 一键启动智能电表演示:

docker run -d --name smart-meter -p 3001:3001 kwdb/smart-meter:latest

启动后访问 http://localhost:3001 即可体验

KWDB 提供了多种容器镜像下载渠道

  • Docker Hub: kwdb/smart-meter
  • 阿里云: registry.cn-hangzhou.aliyuncs.com/kwdb/smart-meter
  • GitHub: ghcr.io/kwdb/smart-meter