array_position
-functie
Van toepassing op: Databricks SQL Databricks Runtime
Retourneert de positie van het eerste exemplaar van element
in array
.
Syntaxis
array_position(array, element)
Argumenten
-
array
: Een MATRIX met vergelijkbare elementen. -
element
: Een expressie die overeenkomt met de typen elementen inarray
.
Retouren
Een BIGINT
.
Matrixindexering begint bij 1. Als de elementwaarde NULL
is, wordt een NULL
geretourneerd.
Als het element niet in de matrix wordt gevonden, wordt een 0 geretourneerd.
Voorbeelden
-- 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