array_position-functie

Van toepassing op: Databricks SQL Databricks Runtime

Retourneert de positie van het eerste voorkomen van element in array.

Syntaxis

array_position(array, element)

Argumenten

• array: Een ARRAY met vergelijkbare elementen.
• element: Een expressie die overeenkomt met de typen elementen in array.

Retouren

Een BIGINT.

Matrixindexering begint bij 1. Als de elementwaarde NULLis, 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

Gerelateerde functies

• [] (haakteken) operator
• array_contains functie
• arrays_overlap-functie