Day 4 - 时间范围查询、分页与统计

建议用时：150-210 分钟

你将学会什么

写参数化时间查询
分页或游标加载
在数据库完成聚合

历史页面不能一次加载全部数据，要按点位、起止时间和页大小查询。今天的 3 个例子都要亲手敲，不能只复制，也不能只看运行结果。

标为 Program.cs 的最小例子可以放进控制台练习项目；标为 Service、ViewModel、XAML 或 SQL 文件的例子，要在本周项目中按前一天已经建立的模型继续敲。文件名和上下文不同，不要把所有片段塞进同一个 Program.cs。

学习衔接

这是 Week 18 的第 4 天。先使用前面已经掌握的 C#、异步、异常、接口和 MVVM，只增加今天这一层上位机能力。

今天的最低通过线

顺序	必须掌握	怎么证明
1	写参数化时间查询	能用自己的话解释并完成对应例子
2	分页或游标加载	能用自己的话解释并完成对应例子
3	在数据库完成聚合	能用自己的话解释并完成对应例子

先用大白话理解

历史页面不能一次加载全部数据，要按点位、起止时间和页大小查询。

学习时固定按这个顺序：


先看数据是什么
-> 再看最小代码
-> 对照运行结果
-> 修改一个参数
-> 故意制造错误
-> 最后组合进上位机项目

例子 1：时间范围查询

文件：queries.sql


SELECT source_time_utc, value_real, quality
FROM tag_samples
WHERE tag_id = $tag
  AND source_time_utc >= $from
  AND source_time_utc < $to
ORDER BY source_time_utc
LIMIT $limit;

运行结果或界面效果：


返回指定点位和时间范围的数据

必须改一次： 解释结束时间为什么使用小于。

例子 2：读取结果

文件：Program.cs


while (await reader.ReadAsync(token))
{
    DateTime time = DateTime.Parse(reader.GetString(0), null, DateTimeStyles.RoundtripKind);
    double value = reader.GetDouble(1);
    rows.Add(new HistoryRow(time, value));
}

运行结果或界面效果：


每行转换成 HistoryRow

必须改一次： 处理 value_real 为 NULL。

例子 3：按分钟聚合

文件：queries.sql


SELECT strftime('%Y-%m-%dT%H:%M:00Z', source_time_utc) AS minute,
       AVG(value_real), MIN(value_real), MAX(value_real)
FROM tag_samples
WHERE tag_id = $tag AND source_time_utc >= $from
GROUP BY minute
ORDER BY minute;

运行结果或界面效果：


每分钟返回平均、最小和最大值

必须改一次： 用于长时间历史趋势。

常见错误和修法

页面打开就 SELECT 全表
时间字符串格式不统一导致排序错误
能在 SQL 聚合却把百万行加载到内存

修错顺序固定为：先看第一条异常和行号，再看输入数据，再看原始字节或状态，最后才怀疑框架。

小白重复敲写训练

不看上面的代码，重新敲“时间范围查询”。
不看上面的代码，重新敲“读取结果”。
不看上面的代码，重新敲“按分钟聚合”。
完成改动任务：解释结束时间为什么使用小于。
完成改动任务：处理 value_real 为 NULL。
完成改动任务：用于长时间历史趋势。

每日小测

今天的知识在上位机里解决什么问题？
三个例子分别输入了什么，输出了什么？
如果运行结果不对，你第一步检查什么？
哪一段代码负责停止、超时或错误处理？

小测答案

答案不能只背一句话。回到三个例子，用代码中的变量、方法和输出逐项说明。能脱离页面说清楚，才算真的理解。

今日作业

新建空项目，不复制地重做三个例子。
每个例子都完成“必须改一次”。
故意制造一个错误，记录错误文字和修复办法。
把今天代码提交到自己的练习仓库。

作业验收

三个例子都能运行或显示预期界面。
能解释关键数据从哪里来、经过什么处理、最后去哪里。
失败时不会让程序无提示崩溃。
能说出今天内容如何进入“采集历史数据库与查询页面”。