ARRAY_LENGTH

Devuelve la longitud de un array en la dimensión indicada.

PostgreSQL 17.9

ARRAY_LENGTH(array, dimension)

array: Array
anyarray
dimension: Número de la dimensión, 1 para un array normal
integer

Valor devuelto

Número entero; NULL para un array vacío

Ejemplos

Longitud del array por dimensión

PostgreSQL 17.9

SELECT ARRAY_LENGTH(ARRAY [10, 20, 30], 1) AS len,
	ARRAY_LENGTH(
		ARRAY [[1, 2],
		[3, 4],
		[5, 6]], 2) AS second_dim,
    ARRAY_LENGTH('{}'::integer[],
		1
	) AS empty_array;

len	second_dim	empty_array
3	2	<NULL>

Número de miembros de la familia por estado

PostgreSQL 17.9

SELECT status,
	ARRAY_LENGTH(ARRAY_AGG(member_name), 1) AS members
FROM FamilyMembers
GROUP BY status
ORDER BY status;

status	members
daughter	3
father	2
mother	2
son	1

Detalles

Para un array vacío la función devuelve NULL, no 0, así que al contar resulta útil COALESCE(ARRAY_LENGTH(a, 1), 0). El número total de elementos en todas las dimensiones lo devuelve CARDINALITY, que para un array vacío da 0.

Véase también

ARRAY_AGG UNNEST