try_element_at Functie

  • Artikel

Van toepassing op:controleren met ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime 10.0 en hoger

Retourneert het element van een arrayExpr op index, of NULL als index buiten de afhankelijkheid is.

Retourneert de waarde van mapExpr voor key, of NULL-id key bestaat niet.

Syntaxis

try_element_at(arrayExpr, index)

try_element_at(mapExpr, key)

Argumenten

  • arrayExpr: Een MATRIX-expressie.
  • index: Een integer-expressie.
  • mapExpr: een MAP-expressie.
  • key: Een expressie die overeenkomt met het type van de sleutels van mapExpr

Retourneert

Als het eerste argument een MATRIX is:

  • Het resultaat is van het type van de elementen van expr.
  • abs(index) mag niet 0 zijn.
  • Als index negatief is, krijgt de functie toegang tot elementen van de laatste tot de eerste.
  • De functie retourneert NULL als abs(index) de lengte van de matrix overschrijdt of als key deze niet bestaat in de kaart.

Voorbeelden

> SELECT try_element_at(array(1, 2, 3), 2);
 2

> SELECT try_element_at(array(1, 2, 3), 5);
 NULL

> SELECT element_at(array(1, 2, 3), 5);
 Error: INVALID_ARRAY_INDEX_IN_ELEMENT_AT

> SELECT try_element_at(map(1, 'a', 2, 'b'), 2);
 b

> SELECT element_at(map(1, 'a', 2, 'b'), 3);
 NULL

> SELECT try_element_at(map(1, 'a', 2, 'b'), 3);
 NULL