PostgreSQL数组函数的使用

 更新时间:2026年06月03日 09:02:04   作者:逍遥运德  
在PostgreSQL18 中,数组类型提供了非常丰富的内置函数,可以极大地提升对数组数据的处理效率,以下为整理了 PostgreSQL 操作数组的常用函数

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

📏 创建数组

在 PostgreSQL 中创建数组,通常分为在表中定义数组字段在查询中直接构造数组两种情况。

以下是详细的操作方法:

1. 在表中定义数组字段

在创建表时,可以在任何标准的数据类型(如 TEXTINTEGER 等)后面加上方括号 [] 来声明该字段为数组。

  • 一维数组:使用 数据类型[]
  • 多维数组:使用 数据类型[][](实际上 PostgreSQL 不强制限制维度,但这样写语义更清晰)
-- 创建一个包含一维和二维数组字段的表
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name TEXT,
    tags TEXT[],           -- 定义一个文本类型的一维数组
    scores INTEGER[],      -- 定义一个整数类型的一维数组
    matrix INTEGER[][]     -- 定义一个整数类型的二维数组
);

PostgreSQL 也支持符合 SQL 标准的 ARRAY 关键字语法,例如 tags TEXT ARRAY 或 scores INTEGER ARRAY

不过需要注意,PostgreSQL 目前不会强制限制数组的实际长度或维度,声明时指定的大小(如 ``)仅起到文档说明的作用2。

2. 向数组字段插入数据

插入数组数据主要有两种写法:使用花括号 {} 或者使用 ARRAY 构造器2。

-- 方式一:使用 ARRAY 构造器(推荐,更直观)
INSERT INTO users (name, tags, scores, matrix)
VALUES ('Alice', ARRAY['developer', 'gamer'], ARRAY, ARRAY[,]);


-- 方式二:使用花括号字面量(注意内部字符串通常需要加双引号)
INSERT INTO users (name, tags, scores)
VALUES ('Bob', '{"teacher", "writer"}', '{75, 80, 85}');

3. 在查询中直接创建/构造数组

如果不需要将数组存入表中,只是想在 SQL 查询过程中临时创建一个数组,可以使用以下几种方式:

使用 ARRAY[] 构造器:sql

SELECT ARRAY;                -- 结果: {1,2,3}
SELECT ARRAY['a', 'b', 'c'];          -- 结果: {a,b,c}
SELECT ARRAY[, ];           -- 结果: {{1,2},{3,4}} (二维数组)

使用 string_to_array 函数(将字符串按分隔符转为数组):sql

SELECT string_to_array('apple,banana,orange', ','); 

-- 结果: {apple,banana,orange}

使用 array_agg 聚合函数(将多行数据合并为一个数组):sql

-- 假设有一个包含分数的表,将分数聚合成数组
SELECT array_agg(score) FROM user_scores WHERE user_id = 1;

💡 补充小知识

数组下标从 1 开始:PostgreSQL 的数组索引默认是从 1 开始的,而不是 01。

  • 例如 SELECT tags FROM users; 会取出数组的第一个元素。

数组查询:可以使用 ANY 或包含操作符 @> 来查询数组中是否包含某个元素。

  • 例如:SELECT * FROM users WHERE 'gamer' = ANY(tags);

📏 数组基本信息与维度函数

array_length(anyarray, int)
返回数组在指定维度上的长度。

SELECT array_length(ARRAY, 1);  
-- 返回 

array_lower(anyarray, int)
返回数组在指定维度上的下界(最低索引)。

SELECT array_lower(ARRAY, 1);  
-- 返回 1

array_upper(anyarray, int)
返回数组在指定维度上的上界(最高索引)。

SELECT array_upper(ARRAY, 1);  
-- 返回 

array_ndims(anyarray)
返回数组的维数(例如一维数组返回1,二维数组返回2)。

1SELECT array_ndims(ARRAY[, ]);  

-- 返回 2

array_dims(anyarray)
返回数组维数的文本表示(包含下标范围)。

SELECT array_dims(ARRAY[, ]);  

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

➕ 数组增删与拼接函数

array_append(anyarray, anyelement)
向数组的末尾添加一个元素。

SELECT array_append(ARRAY, 3);  

-- 返回 {1,2,3}

array_prepend(anyelement, anyarray)
向数组的开头添加一个元素。

SELECT array_prepend(1, ARRAY);  

-- 返回 {1,2,3,4,5}

array_cat(anyarray, anyarray)
将两个数组拼接成一个新数组。

SELECT array_cat(ARRAY1, ARRAY2); 

 -- 返回 {1,2,3,4,5,6}

array_remove(anyarray, anyelement)
从数组中删除所有等于指定值的元素。

-- 例如从数组中删除元素 3
SELECT array_remove(ARRAY, 3);  

-- 返回 {1,2,4}

🔍 数组搜索与定位函数

array_position(anyarray, anyelement [, integer])
返回指定元素在数组中第一次出现的下标(索引从1开始)。第三个可选参数表示从哪个下标开始搜索。

SELECT array_position(ARRAY['sun','mon','tue'], 'mon');  
-- 返回 2

array_positions(anyarray, anyelement)
返回指定元素在数组中所有出现位置的下标数组。

SELECT array_positions(ARRAY, 1);  
-- 返回 {1,4}

🔄 数组转换与聚合函数

unnest(anyarray)
将数组展开,返回一组行(Set of rows),常用于将数组数据转换成多行记录。

SELECT unnest(ARRAY);  

-- 返回三行,分别为 1, 2, 3

array_agg(expression)
聚合函数,将多行查询结果收集并合并成一个数组。

SELECT array_agg(id) FROM users;  

-- 将 users 表的所有 id 聚合成一个数组

array_to_string(anyarray, text [, text])
将数组元素用指定的分隔符拼接成一个字符串。第三个可选参数用于替代数组中的 NULL 值。

SELECT array_to_string(ARRAY, ', ');  

-- 返回 '1, 2, 3'

string_to_array(text, text [, text])
将字符串按照指定的分隔符拆分成一个数组。第三个可选参数用于指定哪些字符串被视为 NULL。

SELECT string_to_array('1,2,3', ','); 

 -- 返回 {1,2,3}

array_fill(anyelement, int[], [int[]])
使用提供的值和维度(以及可选的下界)创建一个新数组。

SELECT array_fill(7, ARRAY);  

-- 返回 {7,7,7}

array_sort(array1 )

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

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

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

array__reverse(anyarray)

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

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

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

☝ (二),数组操作符

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

⚖️ 数组比较操作符

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

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

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

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

  • =:判断两个数组是否相等。
  • <> :判断两个数组是否不相等。
  • < :判断左侧数组是否小于右侧数组。
  • > :判断左侧数组是否大于右侧数组。
  • <=:判断左侧数组是否小于或等于右侧数组。
  • >=:判断左侧数组是否大于或等于右侧数组。

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

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

🔗 数组拼接操作符 (||)

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

数组与数组拼接:将两个数组合并。

SELECT ARRAY || ARRAY;  

-- 返回 {1,2,3,4,5,6}

元素与数组拼接(前置) :将元素添加到数组的开头。

SELECT 3 || ARRAY;  

-- 返回 {3,4,5,6}

数组与元素拼接(后置) :将元素添加到数组的末尾。

SELECT ARRAY || 7;  

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

🎯 数组包含与重叠操作符

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

  • @>包含。判断左侧数组是否包含右侧数组(即右侧数组的所有元素都在左侧数组中出现过)。
  • <@被包含于。判断左侧数组是否被右侧数组包含(即左侧数组的所有元素都在右侧数组中出现过)。
SELECT ARRAY1 <@ ARRAY2;  

-- 返回 true

&&重叠。判断两个数组是否有共同的元素(只要有一个元素相同即为 true)。sq

SELECT ARRAY1 && ARRAY2;  

-- 返回 true

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

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

到此这篇关于PostgreSQL数组函数的使用的文章就介绍到这了,更多相关PostgreSQL数组函数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!​

相关文章

  • PostgreSQL 数据同步到ES 搭建操作

    PostgreSQL 数据同步到ES 搭建操作

    这篇文章主要介绍了PostgreSQL 数据同步到ES 搭建操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-01-01
  • PostgreSQL数据库的基本查询操作

    PostgreSQL数据库的基本查询操作

    这篇文章采用详细的代码示例为大家介绍了PostgreSQL数据库的基本查询操作使用,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步早日升职加薪
    2022-04-04
  • 在CentOS/Ubuntu环境下搭建PostgreSQL主从复制

    在CentOS/Ubuntu环境下搭建PostgreSQL主从复制

    本文介绍了如何在CentOS/Ubuntu环境下搭建PostgreSQL主从复制,以实现高可用和数据备份,通过配置主从库、备份与恢复等步骤,可以有效降低单点故障带来的影响,提高系统的容灾能力,同时,还提供了内网穿透工具的使用方法,便于远程访问数据库
    2026-04-04
  • Mac OS上安装PostgreSQL完整图文教程

    Mac OS上安装PostgreSQL完整图文教程

    这篇文章主要介绍了Mac OS上安装PostgreSQL的完整图文教程,问文中通过代码详细介绍了如何设置密码、允许远程连接、常用命令、备份与恢复、卸载以及常见问题解决方法,需要的朋友可以参考下
    2026-01-01
  • UAT环境PostgreSQL ON CONFLICT DO UPDATE报错问题及解决

    UAT环境PostgreSQL ON CONFLICT DO UPDATE报错问

    这篇文章主要介绍了UAT环境PostgreSQL ON CONFLICT DO UPDATE报错问题及解决过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-04-04
  • PostgreSQL如何选择合适的数据类型

    PostgreSQL如何选择合适的数据类型

    本文详细介绍了PostgreSQL中各种数据类型的特性、适用场景、潜在陷阱及最佳实践,涵盖了数值、字符、时间、布尔、枚举、网络、JSON、几何、全文搜索、范围、自定义类型等核心类别,并通过真实案例说明了数据类型选型的逻辑,感兴趣的朋友跟随小编一起看看吧
    2026-01-01
  • PostgreSql 导入导出sql文件格式的表数据实例

    PostgreSql 导入导出sql文件格式的表数据实例

    这篇文章主要介绍了PostgreSql 导入导出sql文件格式的表数据实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-01-01
  • PostgreSQL扩展UUID-OSSP的使用方法

    PostgreSQL扩展UUID-OSSP的使用方法

    UUID-OSSP是PostgreSQL提供的一个扩展模块,用于生成符合标准的 UUID,下面就来介绍一下PostgreSQL扩展UUID-OSSP的使用方法,具有一定的参考价值,感兴趣的可以了解一下
    2025-07-07
  • postgresql 实现replace into功能的代码

    postgresql 实现replace into功能的代码

    这篇文章主要介绍了postgresql 实现replace into功能的代码,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-01-01
  • Postgresql中xlog生成和清理逻辑操作

    Postgresql中xlog生成和清理逻辑操作

    这篇文章主要介绍了Postgresql中xlog生成和清理逻辑操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-01-01

最新评论