Funzione array_position
Si applica a: Databricks SQL 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 inarray
.
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