Freigeben über

array_position-Funktion

  • Artikel

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Gibt die Position des ersten Vorkommens von element in array zurück.

Syntax

array_position(array, element)

Argumente

  • array: Ein ARRAY mit vergleichbaren Elementen.
  • element: Ein Ausdruck, der mit den Typen der Elemente in array übereinstimmt.

Gibt zurück

Ein BIGINT.

Die Arrayindizierung beginnt bei 1. Wenn der Elementwert NULList, wird ein NULL zurückgegeben. Wenn das Element im Array nicht gefunden wird, wird ein 0 zurückgegeben.

Beispiele

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