get
-Funktion
Gilt für: Databricks SQL Databricks Runtime 11.3 LTS und höher
Gibt das Element eines Arrayausdrucks (arrayExpr
) bei index
ab 0
zurück.
Syntax
get(arrayExpr, index)
Argumente
arrayExpr
: Ein ARRAY-Ausdruck.index
: Ein INTEGER-Ausdruck, der den Index im Array angibt.
Gibt zurück
Das Ergebnis ist vom Typ der Elemente von arrayExpr
.
Wenn der Index (index
) negativ ist oder außerhalb der Grenzen des Arrays liegt, ist das Ergebnis NULL
.
Soll stattdessen ein Fehler vom Typ INVALID_ARRAY_INDEX zurückgegeben werden, verwenden Sie den Operator arrayExpr[index].
Beispiele
> SELECT element_at(arr, 2), get(arr, 0), get(arr, 2), arr[2] FROM VALUES(array(1, 2, 3)) AS T(arr);
2 1 3 3
> SELECT get(arr, 5), get(arr, -1) FROM VALUES(array(1, 2, 3)) AS T(arr);
NULL NULL