openGauss常用聚集函数介绍与示例（8）

checksum(expression)

描述：返回所有输入值的CHECKSUM值。使用该函数可以用来验证openGauss数据库（不支持openGauss之外的其他数据库）的备份恢复或者数据迁移操作前后表中的数据是否相同。在备份恢复或者数据迁移操作前后都需要用户通过手工执行SQL命令的方式获取执行结果，通过对比获取的执行结果判断操作前后表中的数据是否相同。

 说明：

• 对于大表，CHECKSUM函数可能会需要很长时间。

• 如果某两表的CHECKSUM值不同，则表明两表的内容是不同的。由于CHECKSUM函数中使用散列函数不能保证无冲突，因此两个不同内容的表可能会得到相同的CHECKSUM值，存在这种情况的可能性较小。对于列进行的CHECKSUM也存在相同的情况。

• 对于时间类型timestamp, timestamptz和smalldatetime，计算CHECKSUM值时请确保时区设置一致。

• 若计算某列的CHECKSUM值，且该列类型可以默认转为TEXT类型，则expression为列名。
• 若计算某列的CHECKSUM值，且该列类型不能默认转为TEXT类型，则expression为列名::TEXT。
• 若计算所有列的CHECKSUM值，则expression为表名::TEXT。

可以默认转换为TEXT类型的类型包括：char、name、 int8、 int2、 int1、 int4、 raw、 pg_node_tree、 float4、 float8、 bpchar、 varchar、 nvarchar、 nvarchar2、 date、 timestamp、 timestamptz、 numeric、 smalldatetime，其他类型需要强制转换为TEXT。

返回类型：numeric。

示例：

表中可以默认转为TEXT类型的某列的CHECKSUM值。

openGauss=# SELECT CHECKSUM(inv_quantity_on_hand) FROM tpcds.inventory;
     checksum      
-------------------
 24417258945265247
(1 row)

表中不能默认转为TEXT类型的某列的CHECKSUM值。注意此时CHECKSUM参数是列名::TEXT。

openGauss=# SELECT CHECKSUM(inv_quantity_on_hand::TEXT) FROM tpcds.inventory;
     checksum      
-------------------
 24417258945265247
(1 row)

表中所有列的CHECKSUM值。注意此时CHECKSUM参数是表名::TEXT，且表名前不加Schema。

openGauss=# SELECT CHECKSUM(inventory::TEXT) FROM tpcds.inventory;                    
     checksum      
-------------------
 25223696246875800
(1 row)

first(anyelement)

描述：返回第一个非NULL输入。

返回类型：anyelement

openGauss=# select * from tba;
name 
-----
A    
A    
D    
(4 rows)

openGauss=# select first(name) from tba;
first
-----
A
(1 rows)

last(anyelement)

描述：返回最后一个非NULL输入。

返回类型：anyelement

openGauss=# select * from tba;
name 
-----
A    
A    
D    
(4 rows)

openGauss=# select last(name) from tba;
last
-----
D
(1 rows)

mode() within group (order by value anyelement)

描述：返回某列中出现频率最高的值，如果多个值频率相同，则返回最小的那个值。排序方式和该列类型的默认排序方式相同。其中value为输入参数，可以为任意类型。

返回类型：与输入参数类型相同。

示例：

openGauss=# select mode() within group (order by value) from (values(1, 'a'), (2, 'b'), (2, 'c')) v(value, tag);
 mode
------
    2
(1 row)
openGauss=# select mode() within group (order by tag) from (values(1, 'a'), (2, 'b'), (2, 'c')) v(value, tag);
 mode
------
 a
(1 row)

json_agg(any)

描述：将值聚集为json数组。

返回类型：array-json

示例：

openGauss=# select * from classes;
name | score
-----+-------
A    |     2
A    |     3
D    |     5
D    |
(4 rows)

openGauss=# select name, json_agg(score) score from classes group by name order by name;
name |      score
-----+-----------------
A    | [2, 3]
D    | [5, null]
| [null]
(3 rows)

json_object_agg(any, any)

描述：将值聚集为json对象。

返回类型：object-json

示例：

openGauss=# select * from classes;
name | score
-----+-------
A    |     2
A    |     3
D    |     5
D    |
(4 rows)

openGauss=# select json_object_agg(name, score) from classes group by name order by name;
json_object_agg
-------------------------
{ "A" : 2, "A" : 3 }
{ "D" : 5, "D" : null }
(2 rows)