Compartilhar via

Função array_position

  • Artigo

Aplica-se a:marca de seleção positiva SQL do Databricks marca de seleção positiva 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