Share via


Función try_element_at

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores

Devuelve el elemento de arrayExpr correspondiente a index o NULL si index está fuera del límite.

Devuelve el valor de mapExpr correspondiente a key o NULL si key no existe.

Sintaxis

try_element_at(arrayExpr, index)
try_element_at(mapExpr, key)

Argumentos

  • arrayExpr: expresión ARRAY.
  • index: una expresión INTEGER.
  • mapExpr: expresión MAP.
  • key: expresión que coincide con el tipo de claves de mapExpr

Devoluciones

Si el primer argumento es de matriz:

  • El resultado es del tipo de los elementos de expr.
  • abs(index) no debe ser 0.
  • Si index es negativo, la función accede a los elementos del último al primero.
  • La función devuelve NULL si abs(index) supera la longitud de la matriz o si key no existe en el mapa.

Ejemplos

> 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