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 em array.

Devoluções

Um BIGINT.

A indexação de matrizes começa em 1. Se o valor do elemento for NULL, um NULL será devolvido. Se o elemento não for encontrado no array, é devolvido um 0.

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

Funções relacionadas

• [ ] (sinal de colchete) operador
• array_contains Função
• arrays_overlap Função