NULL 值管理

KaiwuDB 支持向表中未定义 NOT NULL 的列写入 NULL 值，并支持计算和查询插入的 NULL 值。

插入 NULL 值

创建表时，如果表的某个列未被定义为 NOT NULL，则该列可以插入 NULL 值。

说明

向表中写入数据时，会对表的列进行 nullablity（是否可为空值）校验。如果目标列被定义为 NOT NULL，则不能插入 NULL 值，否则系统报错。

以下示例创建 nulls 时序表，并向表中写入 NULL 值。

-- 1. 创建时序表，允许写入 null 值
create table nulls (ts timestamp not null, power int, speed int) tags (id int not null, site int) primary tags (id);
CREATE TABLE

-- 2. 写入null值
insert into nulls values ('2024-01-01 10:00:00', 10, 219, 1, 1), ('2024-01-01 10:10:00', 11, 220, 1,1), ('2024-01-01 10:20:00', 14, 225, 1,1), ('2024-01-01 10:30:00',
null,225,1,1), ('2024-01-01 10:40:00', null, null, 1,1);
INSERT 5

-- 3. 查看表数据
select * from nulls;
             ts             | power | speed | id | site
----------------------------+-------+-------+----+-------
  2024-01-01 10:00:00+00:00 |    10 |   219 |  1 |    1
  2024-01-01 10:10:00+00:00 |    11 |   220 |  1 |    1
  2024-01-01 10:20:00+00:00 |    14 |   225 |  1 |    1
  2024-01-01 10:30:00+00:00 | NULL  |   225 |  1 |    1
  2024-01-01 10:40:00+00:00 | NULL  | NULL  |  1 |    1
(5 rows)

查询 NULL 值

使用 SELECT 查询表数据时，如果查询结果包含 NULL 值，则会显示 NULL。

select * from nulls;
             ts             | power | speed | id | site
----------------------------+-------+-------+----+-------
  2024-01-01 10:00:00+00:00 |    10 |   219 |  1 |    1
  2024-01-01 10:10:00+00:00 |    11 |   220 |  1 |    1
  2024-01-01 10:20:00+00:00 |    14 |   225 |  1 |    1
  2024-01-01 10:30:00+00:00 | NULL  |   225 |  1 |    1
  2024-01-01 10:40:00+00:00 | NULL  | NULL  |  1 |    1
(5 rows)

NULL 值计算规则

KaiwuDB 支持涉及聚合、算术运算等内置函数计算、查询场景时的 NULL 值计算，计算规则如下：

查询场景

使用 SELECT 语句查询 NULL 值时，相应的 NULL 值结果显示为 NULL。

select * from nulls;
ts             | power | speed | id | site
----------------------------+-------+-------+----+-------
2024-01-01 10:00:00+00:00 |    10 |   219 |  1 |    1
2024-01-01 10:10:00+00:00 |    11 |   220 |  1 |    1
2024-01-01 10:20:00+00:00 |    14 |   225 |  1 |    1
2024-01-01 10:30:00+00:00 | NULL  |   225 |  1 |    1
2024-01-01 10:40:00+00:00 | NULL  | NULL  |  1 |    1
(5 rows)

WHERE 条件句使用 NULL 值比较，语法是 is null 或 is not null。

SELECT power FROM nulls WHERE power is NULL;
power
-----
NULL
NULL

WHERE 条件句中使用小于号（<）、大于号（>）、等号（=）与 NULL 比较时，均返回 0 行结果。
```
SELECT power FROM nulls WHERE power > NULL;
power
---
Output has 0 rows
```
WHERE 条件句除上面 is null 或 is not null 过滤语句外，其余情况 NULL 值均不参与计算，NULL 值的行会被忽略掉。
```
SELECT power FROM nulls WHERE power > 1;
power
-----
10
11
14
```

聚合运算
- 使用 count(*) 统计行数时，行数结果包含 NULL 值的行数。
```
select count(*) from nulls;
count
---
5
(5 rows)
```
- SUM、AVG、COUNT、FIRST、LAST 及其它聚合函数指定列聚合运算，NULL 不参与运算。
```
select avg(power) from nulls;
          avg
-------------------------
  11.666666666666666667
(1 row)
```
数学和数值函数
NULL 值的四则运算、round()、pow() 等数学运算，运算结果为 NULL。
```
select power+1 from nulls;
?column?
---
11
12
15
NULL
NULL
(5 rows)
```
日期和时间函数
DAY()、DATE()、ADDTIME() 等函数对 NULL 值进行计算时，结果仍为 NULL。
字符串函数
LOWER、RIGHT、LOCATE 等字符串函数对 NULL 值进行计算时，结果仍为 NULL。

# NULL 值管理

# 插入 NULL 值

# 查询 NULL 值

# NULL 值计算规则

NULL 值管理

插入 NULL 值

查询 NULL 值

NULL 值计算规则