TDengine 聚合函数 VAR_POP 用户手册
VAR_POP 函数用户手册
1. 函数概述
VAR_POP 是 TDengine 的聚合函数，用于计算总体方差（Population Variance），即衡量一组数据的离散程度。总体方差假定所有数据是总体数据而非样本数据。
2. 语法
SELECT VAR_POP(column_name) FROM meters [WHERE condition];
-- 或用于窗口聚合
SELECT VAR_POP(column_name) FROM meters [WHERE condition] INTERVAL(window_size);
column_name：需要计算方差的字段，必须为数值类型（如 FLOAT、DOUBLE、INT 等）。meters：智能电表超级表名。condition：可选，筛选数据的条件。window_size：如1h、1d，窗口聚合单位。
3. 计算原理
总体方差公式：
σ² = Σ(xi - μ)² / N
- σ²：总体方差
- xi：第 i 个数据值
- μ：总体均值
- N：数据总数
4. 为什么要用 VAR_POP？
- 数据波动性分析：方差越大，数据波动越明显。可用于监控电流、电压、功率等参数的稳定性。
- 异常检测：方差异常增大，可能说明设备故障或用电异常。
- 质量评估：评估电网或设备运行的稳定性。
- 趋势分析：对比不同区域或设备的方差，发现用电模式变化。
5. 智能电表表结构举例
CREATE TABLE meters (ts TIMESTAMP,voltage FLOAT,current FLOAT,power FLOAT
) TAGS (groupid INT,location VARCHAR(50)
);
6. 使用场景举例
6.1 电压总体方差分析
SELECT VAR_POP(voltage) AS voltage_var_pop FROM meters WHERE ts >= NOW() - 1d;
说明：统计过去一天所有电表电压的总体方差，分析电网稳定性。
6.2 按区域分组分析电流方差
SELECT location, VAR_POP(current) AS current_var_pop FROM meters WHERE ts >= NOW() - 7d GROUP BY location;
说明：对比不同区域的电流波动情况。
6.3 按设备组分析功率方差
SELECT groupid, VAR_POP(power) AS power_var_pop FROM meters WHERE ts >= NOW() - 30d GROUP BY groupid;
说明：分析不同设备组的功率波动，辅助设备健康管理。
6.4 时间窗口分析
-- 每小时电压方差
SELECT VAR_POP(voltage) AS hourly_voltage_var FROM meters WHERE ts >= NOW() - 1d INTERVAL(1h);-- 每日功率方差
SELECT VAR_POP(power) AS daily_power_var FROM meters WHERE ts >= NOW() - 30d INTERVAL(1d);
说明：监控电力参数在不同时间窗口内的波动性。
6.5 异常检测（嵌套查询）
SELECT groupid, location, voltage_var, current_var, sample_count
FROM (SELECT groupid, location, VAR_POP(voltage) AS voltage_var, VAR_POP(current) AS current_var, COUNT(*) AS sample_countFROM metersWHERE ts >= NOW() - 1hGROUP BY groupid, location
)
WHERE voltage_var > 9.0 OR current_var > 2.0;
说明：筛选出方差异常的设备组和区域，便于运维人员及时处理。
7. VAR_POP 与 STDDEV、STDDEV_POP 的区别
| 函数 | 计算内容 | 公式分母 | 结果类型 | 适用场景 |
|---|---|---|---|---|
| VAR_POP | 总体方差 | N | DOUBLE | 总体波动分析 |
| STDDEV_POP | 总体标准差 | N | DOUBLE | 总体波动分析 |
| STDDEV | 样本标准差 | N-1 | DOUBLE | 样本推断、统计分析 |
- VAR_POP 返回的是方差（波动的平方），STDDEV_POP 返回的是标准差（波动的实际值）。
- 方差适合做数学建模、风险评估、异常检测等场景；标准差更适合直接反映数据的实际波动幅度。
- STDDEV 用于样本数据推断总体特征，适合统计推断和假设检验。
8. 注意事项
- 仅支持数值型字段。
- NULL 值自动忽略。
- 支持窗口聚合和分组聚合。
- 不支持在 WHERE 子句中直接调用聚合函数，若需复杂筛选请使用嵌套查询。
- 方差单位为原数据单位的平方。
通过合理使用 VAR_POP 函数，用户可以高效分析智能电表数据的波动性，辅助异常检测、设备健康管理和电网质量监控。
相关文章
- TDengine 聚合函数 STDDEV 用户手册
- TDengine 聚合函数 STDDEV_POP 用户手册
关于 TDengine
TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。