Função array_position
Aplica-se a: Databricks SQL Databricks Runtime
Devolve a posição da primeira ocorrência de element
in array
.
Sintaxe
array_position(array, element)
Argumentos
-
array
: Um ARRAY com elementos comparáveis. -
element
: Uma expressão que corresponde aos tipos dos elementos emarray
.
Devoluções
Um BIGINT
.
A indexação de matrizes começa em 1. Se o valor do elemento for NULL
, um NULL
será retornado.
Se o elemento não for encontrado na matriz, um 0 será retornado.
Exemplos
-- 1 exists twice. The function returns the first position
> SELECT array_position(array(3, 2, 1, 4, 1), 1);
3
-- this function cannot be used to find the position of a NULL element.
> SELECT array_position(array(3, NULL, 1), NULL)
NULL
> SELECT array_position(array(3, 2, 1), NULL)
NULL
-- The element is not found in the array
> SELECT array_position(array(3, 2, 1, 4, 1), 5)
0