华为云首页 用户手册

云数据库 GAUSSDB-数组函数和操作符:数组函数

云数据库 GAUSSDB-数组函数和操作符:数组函数

时间：2024-11-13 14:46:58
云数据库 GAUSSDB 函数和操作符

数组函数

  • array_append(anyarray, anyelement)

    描述：向数组末尾添加元素，只支持一维数组。

    返回类型：anyarray

    示例：

    1
2
3
4
5
    		 
    gaussdb=# SELECT array_append(ARRAY[1,2], 3) AS RESULT;
 result  
---------
 {1,2,3}
(1 row)
  • array_prepend(anyelement, anyarray)

    描述：向数组开头添加元素，只支持一维数组。

    返回类型：anyarray

    示例：

    1
2
3
4
5
    		 
    gaussdb=# SELECT array_prepend(1, ARRAY[2,3]) AS RESULT;
 result  
---------
 {1,2,3}
(1 row)
  • array_cat(anyarray, anyarray)

    描述：连接两个数组，支持多维数组。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    		 
    gaussdb=# SELECT array_cat(ARRAY[1,2,3], ARRAY[4,5]) AS RESULT;
   result    
-------------
 {1,2,3,4,5}
(1 row)

gaussdb=# SELECT array_cat(ARRAY[[1,2],[4,5]], ARRAY[6,7]) AS RESULT;
       result        
---------------------
 {{1,2},{4,5},{6,7}}
(1 row)
  • array_union(anyarray, anyarray)

    描述：连接两个数组，只支持一维数组。有入参为NULL时返回另一个入参。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    		 
    gaussdb=# SELECT array_union(ARRAY[1,2,3], ARRAY[3,4,5]) AS RESULT;
   result    
-------------
 {1,2,3,3,4,5}
(1 row)

gaussdb=# SELECT array_union(ARRAY[1,2,3], NULL) AS RESULT;
 result  
---------
 {1,2,3}
(1 row)
  • array_union_distinct(anyarray, anyarray)

    描述：连接两个数组，并去重，只支持一维数组。有入参为NULL时返回另一个入参。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    		 
    gaussdb=# SELECT array_union_distinct(ARRAY[1,2,3], ARRAY[3,4,5]) AS RESULT;
   result    
-------------
 {1,2,3,4,5}
(1 row)

gaussdb=# SELECT array_union_distinct(ARRAY[1,2,3], NULL) AS RESULT;
 result  
---------
 {1,2,3}
(1 row)
  • array_intersect(anyarray, anyarray)

    描述：两个数组取交集，只支持一维数组。有入参为NULL时返回NULL。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    		 
    gaussdb=# SELECT array_intersect(ARRAY[1,2,3], ARRAY[3,4,5]) AS RESULT;
   result    
-------------
 {3}
(1 row)

gaussdb=# SELECT array_intersect(ARRAY[1,2,3], NULL) AS RESULT;
 result 
--------

(1 row)
  • array_intersect_distinct(anyarray, anyarray)

    描述：两个数组取交集，并去重，只支持一维数组。有入参为NULL时返回NULL。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    		 
    gaussdb=# SELECT array_intersect_distinct(ARRAY[1,2,2], ARRAY[2,2,4,5]) AS RESULT;
   result    
-------------
 {2}
(1 row)

gaussdb=# SELECT array_intersect_distinct(ARRAY[1,2,3], NULL) AS RESULT;
 result 
--------

(1 row)
  • array_except(anyarray, anyarray)

    描述：两个数组取差，只支持一维数组。第一个入参为NULL时返回NULL, 第二个入参为NULL时返回第一个入参。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
    		 
    gaussdb=# SELECT array_except(ARRAY[1,2,3], ARRAY[3,4,5]) AS RESULT;
   result    
-------------
 {1,2}
(1 row)

gaussdb=# SELECT array_except(ARRAY[1,2,3], NULL) AS RESULT;
 result  
---------
 {1,2,3}
(1 row)

gaussdb=# SELECT array_except(NULL, ARRAY[3,4,5]) AS RESULT;
 result 
--------

(1 row)
  • array_except_distinct(anyarray, anyarray)

    描述：两个数组取差，并去重，只支持一维数组。第一个入参为NULL时返回NULL, 第二个入参为NULL时返回第一个入参。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
    		 
    gaussdb=# SELECT array_except_distinct(ARRAY[1,2,2,3], ARRAY[3,4,5]) AS RESULT;
   result    
-------------
 {1,2}
(1 row)

gaussdb=# SELECT array_except_distinct(ARRAY[1,2,3], NULL) AS RESULT;
 result  
---------
 {1,2,3}
(1 row)

gaussdb=# SELECT array_except_distinct(NULL, ARRAY[3,4,5]) AS RESULT;
 result 
--------

(1 row)
  • array_ndims(anyarray)

    描述：返回数组的维数。

    返回类型：int

    示例：

    1
2
3
4
5
    		 
    gaussdb=# SELECT array_ndims(ARRAY[[1,2,3], [4,5,6]]) AS RESULT;
 result 
--------
      2
(1 row)
  • array_dims(anyarray)

    描述：返回数组各个维度中的低位下标值和高位下标值。

    返回类型：text

    示例：

    1
2
3
4
5
    		 
    gaussdb=# SELECT array_dims(ARRAY[[1,2,3], [4,5,6]]) AS RESULT;
   result   
------------
 [1:2][1:3]
(1 row)
  • array_length(anyarray, int)

    描述：返回指定数组维度的长度。int为指定数组维度。

    返回类型：int

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    		 
    gaussdb=# SELECT array_length(array[1,2,3], 1) AS RESULT;
 result 
--------
      3
(1 row)

gaussdb=# SELECT array_length(array[[1,2,3],[4,5,6]], 2) AS RESULT;
 result
--------
      3
(1 row)
  • array_lower(anyarray, int)

    描述：返回指定数组维数的下界。int为指定数组维度。

    返回类型：int

    示例：

    1
2
3
4
5
    		 
    gaussdb=# SELECT array_lower('[0:2]={1,2,3}'::int[], 1) AS RESULT;
 result 
--------
      0
(1 row)

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL。

  • array_sort(anyarray)

    描述：返回从小到大排列好的数组。只支持一维anyarray数组排序，多维数组返回NULL值。目前暂不支持record、xml、xmltype、json类型数组排序。

    返回类型：anyarray

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
    		 
    gaussdb=# SELECT array_sort(ARRAY[5,1,3,6,2,7]) AS RESULT;
 result 
-------------
{1,2,3,5,6,7}
(1 row)
gaussdb=# SELECT array_sort(array[array[1,23], array[1,34]]);
 array_sort  
-------------
 {NULL,NULL}
(1 row)
  • array_upper(anyarray, int)

    描述：返回指定数组维数的上界。int为指定数组维度。

    返回类型：int

    示例：

    1
2
3
4
5
    		 
    gaussdb=# SELECT array_upper(ARRAY[1,8,3,7], 1) AS RESULT;
 result 
--------
      4
(1 row)

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL。

  • array_to_string(anyarray, text [, text])

    描述：使用第一个text作为数组的新分隔符，使用第二个text替换数组值为NULL的值。

    返回类型：text

    示例：

    1
2
3
4
5
    		 
    gaussdb=# SELECT array_to_string(ARRAY[1, 2, 3, NULL, 5], ',', '*') AS RESULT;
  result   
-----------
 1,2,3,*,5
(1 row)
  • array_delete(anyarray)

    描述：清空数组中的元素并返回一个同类型的空数组。

    返回类型：anyarray

    示例：

    gaussdb=# SELECT array_delete(ARRAY[1,8,3,7]) AS RESULT;
 result 
--------
 {}
(1 row)

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL。

  • array_deleteidx(anyarray, int)

    描述：从数组中删除指定下标的元素并返回剩余元素组成的数组。

    返回类型：anyarray

    示例：

    gaussdb=# SELECT array_deleteidx(ARRAY[1,2,3,4,5], 1) AS RESULT;
  result
-----------
 {2,3,4,5}
(1 row)
    • array_deleteidx(anyarray, int)此函数在参数a_format_version值为10c和a_format_dev_version值为s1的情况下被禁用。
    • 在开启varray_compat参数后，如果第一个参数为null会报错Reference to uninitialized collection，第二个参数为null返回原数组，未开启该参数时，参数有一个为null则返回null；若第二个参数小于等于0时开启参数后会报错Subscript outside of limit，开启前返回原数组；若第二个参数大于该数组元素数量时(包括0即空数组)开启参数后会报错Subcript outside of count开启前返回原数组。
  • array_extendnull(anyarray, int)

    描述：往数组尾部添加指定个数的NULL空元素。

    返回类型：anyarray

    示例：

    gaussdb=# SELECT array_extendnull(ARRAY[1,8,3,7],1) AS RESULT;
    result 
--------------
{1,8,3,7,null}
(1 row)

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL；如果第二个参数为NULL，开启参数前返回NULL，开启后返回原数组；若第二个参数小于0开启参数后报错numeric or value error开启前返回原数组。

  • array_extendnull(anyarray, int, int)

    描述：往数组尾部添加指定个数的指定索引的元素。

    返回类型：anyarray

    示例：

    gaussdb=# SELECT array_extendnull(ARRAY[1,8,3,7],2,2) AS RESULT;
    result 
--------------
{1,8,3,7,8,8}
(1 row)

    array_extendnull(anyarray, int, int)此函数在参数a_format_version值为10c和a_format_dev_version值为s1的情况下有效。

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL；如果第二个参数或者第三个参数为NULL，开启参数前返回NULL，开启后返回原数组。

  • array_trim(anyarray, int)

    描述：从数组尾部删除指定个数个元素。

    返回类型：anyarray

    示例：

    gaussdb=# SELECT array_trim(ARRAY[1,8,3,7],1) AS RESULT;
 result
---------
 {1,8,3}
(1 row)

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL；如果第二个参数为NULL，开启参数前返回NULL，开启后返回原数组；如果第二个参数超过数组元素个数(包括0即空数组)时开启参数后会报错Subscipt outside of count，开启前返回空数组，如果第二个参数小于0开启后报错numeric or value error，开启前返回原数组。

  • array_exists(anyarray, int)

    描述：检查第二个参数是否是数组的合法下标。

    返回类型：boolean

    示例：

    gaussdb=# SELECT array_exists(ARRAY[1,8,3,7],1) AS RESULT;
 result 
--------
 t
(1 row)
  • array_next(anyarray, int)

    描述：根据第二个入参返回数组中指定下标元素的下一个元素的下标。

    返回类型：int

    示例：

    gaussdb=# SELECT array_next(ARRAY[1,8,3,7],1) AS RESULT;
 result 
--------
      2
(1 row)

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL。

  • array_prior(anyarray, int)

    描述：根据第二个入参返回数组中指定下标元素的上一个元素的下标。

    返回类型：int

    示例：

    gaussdb=# SELECT array_prior(ARRAY[1,8,3,7],2) AS RESULT;
 result 
--------
  1
(1 row)

    如果第一个参数为null开启参数varray_compat后会报错Reference to uninitialized collection，开启前返回NULL。

  • string_to_array(text, text [, text])

    描述：使用第二个text指定分隔符，使用第三个可选的text作为NULL值替换模板，如果分隔后的子串与第三个可选的text完全匹配，则将其替换为NULL。

    返回类型：text[]

    示例：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
    		 
    gaussdb=# SELECT string_to_array('xx~^~yy~^~zz', '~^~', 'yy') AS RESULT;
    result    
--------------
 {xx,NULL,zz}
(1 row)
gaussdb=# SELECT string_to_array('xx~^~yy~^~zz', '~^~', 'y') AS RESULT;
   result   
------------
 {xx,yy,zz}
(1 row)
  • unnest(anyarray)

    描述：扩大一个数组为一组行。

    返回类型：setof anyelement

    示例：

    1
2
3
4
5
6
    		 
    gaussdb=# SELECT unnest(ARRAY[1,2]) AS RESULT;
 result 
--------
      1
      2
(2 rows)
support.huaweicloud.com/centralized-devg-v8-gaussdb/gaussdb-42-0371.html

新客秒杀 2核2G 3M L实例

68元/年

普惠上云 领千元上云礼券

立即前往

企业专享 X实例 4核8G 5M

888元/年

热门域名 1元 随心购

1元/年起

看了此文的人还看了
CDN加速 GaussDB 文字转换成语音 免费的服务器 如何创建网站 域名网站购买 私有云桌面 云主机哪个好 域名怎么备案 手机云电脑 SSL证书申请 云点播服务器 免费OCR是什么 电脑云桌面 域名备案怎么弄 语音转文字 文字图片识别 云桌面是什么 网址安全检测 网站建设搭建 国外CDN加速 SSL免费证书申请 短信批量发送 图片OCR识别 云数据库MySQL 个人域名购买 录音转文字 扫描图片识别文字 OCR图片识别 行驶证识别 虚拟电话号码 电话呼叫中心软件 怎么制作一个网站 Email注册网站 华为VNC 图像文字识别 企业网站制作 个人网站搭建 华为云计算 免费租用云托管 云桌面云服务器 ocr文字识别免费版 HTTPS证书申请 图片文字识别转换 国外域名注册商 使用免费虚拟主机 云电脑主机多少钱 鲲鹏云手机 短信验证码平台 OCR图片文字识别 SSL证书是什么 申请企业邮箱步骤 免费的企业用邮箱 云免流搭建教程 域名价格
云数据库 GAUSSDB-数组函数和操作符:数组函数

搜索反馈

您搜索到想要的结果了吗?

是的 没有

意见反馈

0/200

提交 取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好 反馈提交失败！请稍后重试！
产品专区
推荐文章
更多内容
云硬盘存储EVS Web应用防火墙 人机语音识别 云计算入门 云数据库选择 HDC大会 华为云计算 响应式建站是什么 智慧班牌系统