Função array_position

Aplica-se a: SQL do Databricks Runtime do Databricks

Retorna a posição da primeira ocorrência de element em array.

Sintaxe

array_position(array, element)

Argumentos

• array: uma ARRAY com elementos comparáveis.
• element: uma expressão que corresponde aos tipos dos elementos em array.

Retornos

Um BIGINT.

A indexação de matriz 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

Funções relacionadas

• [ ]Operador (sinal de colchete)
• array_contains função
• arrays_overlap função