PostgreSQL --- 数组函数详解

☝ 数组函数

在 PostgreSQL 18 中，数组类型提供了非常丰富的内置函数，可以极大地提升对数组数据的处理效率。以下为整理了 PostgreSQL 操作数组的常用函数全集及详细讲解：

array_length(anyarray, int)
返回数组在指定维度上的长度。
sql 复制代码
```
SELECT array_length(ARRAY, 1);  
-- 返回 
```
array_lower(anyarray, int)
返回数组在指定维度上的下界（最低索引）。
sql 复制代码
```
SELECT array_lower(ARRAY, 1);  
-- 返回 1
```
array_upper(anyarray, int)
返回数组在指定维度上的上界（最高索引）。
sql 复制代码
```
SELECT array_upper(ARRAY, 1);  
-- 返回 
```
array_ndims(anyarray)
返回数组的维数（例如一维数组返回1，二维数组返回2）。
sql 复制代码
```
1SELECT array_ndims(ARRAY[, ]);  

-- 返回 2
```
array_dims(anyarray)
返回数组维数的文本表示（包含下标范围）。
sql 复制代码
```
SELECT array_dims(ARRAY[, ]);  

-- 返回 '[1:2][1:3]'
```

array_append(anyarray, anyelement)
向数组的末尾添加一个元素。
sql 复制代码
```
SELECT array_append(ARRAY, 3);  

-- 返回 {1,2,3}
```
array_prepend(anyelement, anyarray)
向数组的开头添加一个元素。
sql 复制代码
```
SELECT array_prepend(1, ARRAY);  

-- 返回 {1,2,3,4,5}
```
array_cat(anyarray, anyarray)
将两个数组拼接成一个新数组。
sql 复制代码
```
SELECT array_cat(ARRAY1, ARRAY2); 

 -- 返回 {1,2,3,4,5,6}
```
array_remove(anyarray, anyelement)
从数组中删除所有等于指定值的元素。
sql 复制代码
```
-- 例如从数组中删除元素 3
SELECT array_remove(ARRAY, 3);  

-- 返回 {1,2,4}
```

array_position(anyarray, anyelement $, integer$ )
返回指定元素在数组中第一次 出现的下标（索引从1开始）。第三个可选参数表示从哪个下标开始搜索。
sql 复制代码
```
SELECT array_position(ARRAY['sun','mon','tue'], 'mon');  
-- 返回 2
```
array_positions(anyarray, anyelement)
返回指定元素在数组中所有出现位置的下标数组。
sql 复制代码
```
SELECT array_positions(ARRAY, 1);  
-- 返回 {1,4}
```

unnest(anyarray)
将数组展开，返回一组行（Set of rows），常用于将数组数据转换成多行记录。
sql 复制代码
```
SELECT unnest(ARRAY);  

-- 返回三行，分别为 1, 2, 3
```
array_agg(expression)
聚合函数，将多行查询结果收集并合并成一个数组。
sql 复制代码
```
SELECT array_agg(id) FROM users;  

-- 将 users 表的所有 id 聚合成一个数组
```
array_to_string(anyarray, text $, text$ )
将数组元素用指定的分隔符拼接成一个字符串。第三个可选参数用于替代数组中的 NULL 值。
sql 复制代码
```
SELECT array_to_string(ARRAY, ', ');  

-- 返回 '1, 2, 3'
```
string_to_array(text, text $, text$ )
将字符串按照指定的分隔符拆分成一个数组。第三个可选参数用于指定哪些字符串被视为 NULL。
sql 复制代码
```
SELECT string_to_array('1,2,3', ','); 

 -- 返回 {1,2,3}
```
array_fill(anyelement, int\[\], $int\[$ ])
使用提供的值和维度（以及可选的下界）创建一个新数组。
sql 复制代码
```
SELECT array_fill(7, ARRAY);  

-- 返回 {7,7,7}
```

对数组的第一维元素进行升序排序。

sql 复制代码

-- 将数组元素按升序排列
SELECT array_sort(ARRAY1);

-- 结果: {1,1,3,4,5,9}

将数组中的元素顺序完全反转。

sql 复制代码

-- 将数组元素倒序排列
SELECT array_reverse(ARRAY);

-- 结果: {5,4,3,2,1}

在 PostgreSQL 中，除了丰富的数组函数外，数组操作符也是处理数组数据的核心工具。

这些操作符用于对两个数组进行比较，它们会对数组内容进行逐个元素的对比。

原生数组比较是严格匹配 的，它不仅要求数组中的元素完全一致，还要求元素的顺序 和数组的维度也必须完全相同。

顺序敏感：如果两个数组包含的元素相同，但顺序不同，它们会被视为不相等。

类型与维度敏感 ：即使通过类型转换让元素值看起来一样，如果底层类型或维度不同，也可能影响比较结果（不过在标准的同类型比较中，= 会进行合理的类型匹配）。

💡 提示 ：数组的排序比较（<, > 等）是基于 B-tree 比较函数逐个元素进行的，直到遇到第一个不同的元素来决定大小。

由于原生的 = 操作符对顺序敏感，可以通过先排序再比较的方式来实现。

|| 操作符非常灵活，既可以用于数组之间的拼接，也可以用于将单个元素与数组拼接。

数组与数组拼接 ：将两个数组合并。
sql 复制代码
```
SELECT ARRAY || ARRAY;  

-- 返回 {1,2,3,4,5,6}
```
元素与数组拼接（前置） ：将元素添加到数组的开头。
sql 复制代码
```
SELECT 3 || ARRAY;  

-- 返回 {3,4,5,6}
```
数组与元素拼接（后置） ：将元素添加到数组的末尾。
sql 复制代码
```
SELECT ARRAY || 7;  

-- 返回 {4,5,6,7}
```

这些操作符常用于复杂的条件过滤，判断数组之间的包含关系或是否有共同元素。

@> ：包含。判断左侧数组是否包含右侧数组（即右侧数组的所有元素都在左侧数组中出现过）。
<@ ：被包含于 。判断左侧数组是否被右侧数组包含（即左侧数组的所有元素都在右侧数组中出现过）。
sql 复制代码
```
SELECT ARRAY1 <@ ARRAY2;  

-- 返回 true
```
&& ：重叠。判断两个数组是否有共同的元素（只要有一个元素相同即为 true）。sq
sql 复制代码
```
SELECT ARRAY1 && ARRAY2;  

-- 返回 true
```

💡 提示 ：在包含操作符（@> 和 <@）中，重复的元素值不做特殊处理。例如 ARRAY 和 ARRAY 会被认为互相包含。

掌握这些操作符，配合上一轮提到的数组函数，就能在 PostgreSQL 中游刃有余地处理各种复杂的数组业务逻辑了