TDengine 数据函数 MOD 用户手册

MOD 函数

语法

sql 复制代码

MOD(expr1, expr2)

功能说明

计算 expr1 % expr2 的结果（余数/取模）。
整数参与时行为等同数学取模；浮点参与时按浮点余数规则计算，结果类型为 DOUBLE。

版本

v3.3.3.0

返回结果类型

DOUBLE

适用数据类型

数值类型

嵌套子查询支持

适用于内层查询和外层查询

适用于

表和超级表

使用说明

参数必须为 2 个。
若 expr2 为 0，返回 NULL。
若任一参数为 NULL，返回 NULL。
可与选择（Selection）、投影（Projection）一起使用，不与聚合（Aggregation）在同层直接混用。

示例所用表与数据（可直接复制执行）

sql 复制代码

-- 建库与使用
CREATE DATABASE IF NOT EXISTS power;
USE power;

-- 按要求的智能电表表结构
CREATE STABLE meters (
  ts TIMESTAMP,
  current FLOAT,
  voltage INT,
  power DOUBLE
) TAGS (
  groupid INT,
  location VARCHAR(64)
);

-- 子表
CREATE TABLE d1001 USING meters TAGS (1, 'SF');
CREATE TABLE d1002 USING meters TAGS (2, 'LA');

-- 写入数据
INSERT INTO d1001 VALUES
  ('2024-01-01 10:00:00.000', 10.3, 220, 2266.0),
  ('2024-01-01 10:01:00.000', 12.6, 221, 2784.6),
  ('2024-01-01 10:02:00.000',  8.5, 223, 1895.5);

INSERT INTO d1002 VALUES
  ('2024-01-01 10:00:00.000',  9.0, 219, 1971.0),
  ('2024-01-01 10:01:00.000', 14.0, 222, 3108.0),
  ('2024-01-01 10:02:00.000',  7.2, 220, 1584.0);

基础示例

sql 复制代码

-- 常量取模
SELECT MOD(10, 3) AS r1, MOD(-10, 3) AS r2, MOD(10, -3) AS r3;

-- 浮点取模
SELECT MOD(10.5, 3) AS r4;

-- 非法与 NULL 输入
SELECT MOD(10, 0) AS r5, MOD(NULL, 3) AS r6, MOD(10, NULL) AS r7;

列参与计算

sql 复制代码

-- 电压奇偶标记（偶数电压 remainder=0）
SELECT ts, voltage, MOD(voltage, 2) AS vol_parity
FROM d1001
ORDER BY ts;

-- 功率按 10 分桶（0~9 桶）
SELECT ts, power, MOD(power, 10) AS power_bin10
FROM d1002
WHERE power > 0
ORDER BY ts;

-- 超级表查询：查看各表电压对 10 的余数
SELECT tbname, ts, voltage, MOD(voltage, 10) AS v_mod10
FROM meters
ORDER BY tbname, ts;

作为过滤条件

sql 复制代码

-- 仅保留偶数电压的记录（用于相位/合规校验）
SELECT ts, voltage, current
FROM d1002
WHERE MOD(voltage, 2) = 0
ORDER BY ts;

分组统计中的分桶用法

sql 复制代码

-- 电压末位（对 10 取模）分布
SELECT MOD(voltage, 10) AS v_last_digit, COUNT(*) AS cnt
FROM meters
GROUP BY v_last_digit
ORDER BY v_last_digit;

生产场景应用与意义

场景 A：偶数电压筛选（合规/相位对齐）
- 目的：筛出满足偶数电压的样本，用于配电相位对齐或设备接线合规性检查。
- 示例：
sql 复制代码
```
SELECT ts, voltage
FROM meters
WHERE MOD(voltage, 2) = 0
ORDER BY ts;
```
场景 B：分桶统计（量程与量化噪声评估）
- 目的：用 MOD(voltage, 10) 观察电压末位分布，评估传感器量化级与噪声特征，辅助设定告警阈值与去噪策略。
- 示例：
sql 复制代码
```
SELECT MOD(voltage, 10) AS bucket, COUNT(*) AS cnt
FROM meters
GROUP BY bucket
ORDER BY bucket;
```
场景 C：任务分片/并行处理（基于标签分片）
- 目的：按 groupid 对数据分片，便于多任务并行消费与负载均衡。
- 示例（按 4 片路由）：
sql 复制代码
```
SELECT tbname, groupid, location, MOD(groupid, 4) AS shard
FROM meters
GROUP BY tbname, groupid, location
ORDER BY shard, tbname;
```
场景 D：定期抽样触发（流水线抽检）
- 目的：按固定步长触发规则校验/抽检（以电压为计数近似示例，生产中可换为序列号/计数列）。
- 示例（每 5 个电压单位触发一次）：
sql 复制代码
```
SELECT ts, voltage, current
FROM meters
WHERE MOD(voltage, 5) = 0
ORDER BY ts;
```

注意事项

除数为 0 返回 NULL，建议在 WHERE 中预先规避。
浮点参与计算返回 DOUBLE，注意浮点精度。
与聚合混用需遵循 SQL 分组规则。

关于 TDengine

TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。