ARRAY_LENGTH

功能描述

返回ARRAY类型参数在指定维度的长度。

ARRAY数据类型的详细信息请参见《SQL语法参考指南》的ARRAY数据类型章节。

语法格式

ARRAY_LENGTH(anyarray, integer)

参数说明

• anyarray：要检查其长度的数组，ARRAY类型数据。
• integer: 指定要查询的维度编号（从1开始）。

函数返回类型

INTEGER类型。

示例

一维数组[1, 2, 3]，包含3个元素。返回第一个维度（也是唯一一个维度）的长度，即3。

SQL> SELECT ARRAY_LENGTH(ARRAY[1,2,3], 1);

EXPR1 | 
------------------------------------------------------------------------------
3 |

一维数组[NULL]，包含1个元素。返回第一个维度的长度，即1。

SQL> SELECT ARRAY_LENGTH(ARRAY[NULL], 1);

EXPR1 | 
------------------------------------------------------------------------------
1 |

一维数组['text']，包含1个字符串元素。返回第二个维度的长度，但这个数组只有一个维度，因此没有第二个维度，返回NULL。

SQL> SELECT ARRAY_LENGTH(ARRAY['text'], 2);

EXPR1 | 
------------------------------------------------------------------------------
NULL |