Condividi tramite


Funzione array_position

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Restituisce la posizione della prima occorrenza di element in array.

Sintassi

array_position(array, element)

Argomenti

  • array: matrice con elementi confrontabili.
  • element: espressione che corrisponde ai tipi degli elementi in array.

Valori restituiti

Oggetto BIGINT.

L'indicizzazione della matrice inizia da 1. Se il valore dell'elemento è NULL, viene restituito un NULL. Se l'elemento non viene trovato nella matrice, viene restituito un valore 0.

Esempi

-- 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