第一次上手一款数据库，最费时间的往往不是写 SQL，而是准备环境和数据：库怎么建、样例数据去哪找、脚本按什么顺序运行，都要一点点理清楚。

为了让大家更快跑起来，KWDB SampleDB 把这些准备工作整理成了可以直接体验的示例。目前官网收录了智能电表、跨模查询、窗口函数和聚合函数 4 组内容。无论是梳理关系与时序数据的建模方式，还是验证跨模查询、窗口分析与时序聚合能力，都可以选择对应示例直接上手。

4 组示例，分别能体验什么？

1. 智能电表：从一套完整的 AIoT 模型入门

智能电表场景中，用户和设备信息相对稳定，用电量与运行状态则持续产生。示例使用关系数据库 rdb 管理业务信息，使用时序数据库 tsdb 存储测量数据，并准备了用电量排行、故障电表、告警检测、负荷统计和最近 24 小时趋势等查询。

这组示例串起了建模、数据导入与业务查询，适合第一次接触 KWDB 的开发者。先跑通完整场景，再回头看表结构与 SQL，每一步为什么这样设计会更容易理解。

不想先看脚本？从 Web Demo 逛起

如果想先了解实际效果，可以从“智能电表数据管理与可视化演示”开始。这个 Web Demo 将电表数据管理场景放到页面中呈现，先看业务和数据如何对应，再进入项目目录研究建模与查询脚本，上手会更直观。

👉 运行智能电表示例

👉 查看智能电表 Web Demo

• 相关阅读： 技术贴 | 如何基于 KWDB 快速实现工业物联网智能电表系统设计？
  
  

2. 跨模查询：在一条 SQL 中关联两类数据

设备测量值通常放在时序库中，设备台账、区域和场点信息则放在关系库中。实际分析时，两类数据经常需要放到一起：既要知道设备当前的测量值，也要知道它属于哪个区域、对应哪项业务。

跨模查询示例将这些问题写进一条 SQL，直接关联时序数据与关系数据。运行示例时，可以继续观察跨模连接、聚合下推及查询计划，理解 KWDB 如何处理两类数据的联合分析。

👉 运行跨模查询示例

• 相关阅读：打破存储边界！KWDB 跨模查询如何实现多源数据高效融合？
  

3. 窗口函数：按业务边界切分连续数据

固定时间分桶并不能回答所有时序问题。一次拥堵从何时开始、设备状态持续了多久、相邻记录是否属于同一段会话，都需要不同的窗口规则。

窗口函数示例以交通流量监测为场景，演示 5 种分组方式：COUNT_WINDOW 按记录数分组，EVENT_WINDOW 捕捉事件起止，SESSION_WINDOW 根据时间间隔划分会话，STATE_WINDOW 跟踪状态变化，TIME_WINDOW 按固定时间统计。

在同一批数据上切换窗口规则，可以很直观地比较不同分组结果。这组示例适合用来练习异常区间识别、设备状态跟踪和趋势统计。

👉 运行窗口函数示例

• 相关阅读：《KWDB SampleDB 上新｜新增窗口函数示例》
  

4. 聚合函数：先定口径，再做统计

传感器数据中的平均值并不总是“求和再除以数量”。空值是否参与计算、负数代表异常还是有效观测、采样间隔不一致时如何计算平均值，都会影响结果。

聚合函数示例专门加入了空值、负值和非均匀采样数据。除了 COUNT、AVG、SUM、MIN、MAX、STDDEV 等基础统计，还可以练习 FIRST、LAST、time_bucket、TWA 等时序聚合函数。

跑完这组示例，可以进一步分辨数值边界与时间边界，理解统计范围、设备分组和时间权重如何共同影响查询结果。

👉 运行聚合函数示例

• 相关阅读：《一文读懂 KWDB 聚合函数：结合 SampleDB 实例详细拆解》
  

懒得自己理顺序？用 Agent Skill 跑通完整流程

SampleDB 每个目录都配有数据生成、建库建表、数据导入和查询脚本。想自己研究，可以沿着项目结构逐步执行；想减少环境检查和命令判断，也可以使用仓库新增的 sampledb-quickstart Skill。你可以直接告诉 Agent：

帮我根据当前环境快速体验 SampleDB 示例，并解释每一步做了什么。

Agent 会先检查仓库脚本与 KWDB 运行状态，再根据你的选择准备示例。到了数据准备、建库导入等环节，它会说明操作内容并等待确认。查询时既可以运行完整脚本，也可以单独选择一条 SQL，适合边执行、边看结果、边理解查询逻辑。

把一次体验，写成一篇实践

目前，“KWDB 创作者计划”KaiwuDB 开源两周年特别季社区征文大赛正在征集作品，SampleDB 的上手体验、功能拓展和场景改造都可以投稿“生态实践”方向。文章与视频双赛道均可参加，投稿截止时间为 2026 年 10 月 31 日。

👉 投稿指南：https://www.kaiwudb.com/blog/97908233659904001

如果你已经跑过其中一组示例，不妨把终端里的操作、遇到的问题和验证结果整理出来；如果还没开始，就从最贴近自己业务的一组出发。一次参数调整、一项查询对比，甚至一个没有按预期返回的结果，都可能成为文章里最有价值的部分。

欢迎带上你的 SampleDB 实践，来“KWDB 创作者计划”和更多开发者交流，让你的实操经验被更多人看到吧！

• 进入 KWDB SampleDB 官网：https://kwdb.tech/sampledb

• 查看 SampleDB 开源仓库：https://github.com/KWDB/SampleDB

• “KWDB 创作者计划”征文大赛活动详情：征文大赛 |「KWDB 创作者计划」—— 开源两周年特别季，来了！