Partilhar via


Função array_position

Aplica-se a:Marque Sim Databricks SQL Marque Sim 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á 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