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

Zugehörige Funktionen

• array_contains Funktion
• array_position Funktion
• element_at Funktion
• [] (eckige Klammern)