try_variant_array_append Función

Se aplica a:marcado sí Databricks SQL marcado sí Databricks Runtime 19 y superior

Devuelve variantExpr con val añadido al array en path, o NULL si un valor intermedio tiene un tipo incompatible o el destino no es un array.

Syntax

try_variant_array_append ( variantExpr, path, val )

Argumentos

  • variantExpr: Una VARIANT expresión.
  • path: Una STRING expresión con una expresión de ruta JSON bien formada que especifica el array objetivo. Los índices de los arrays son basados en ceros.
  • val: Una expresión que puede lanzarse a VARIANT.

Returns

Valor de tipo VARIANT.

Un camino perdido deja variantExpr sin cambios.

Los argumentos SQL NULL devuelven SQL NULL.

La función devuelve SQL NULL para tipos intermedios incompatibles o para un destino que no sea de la matriz. Para generar un error en su lugar, usa variant_array_append.

Los trayectos mal formados aumentan INVALID_VARIANT_PATH, y los resultados que superan el límite de tamaño de la variante aumentan VARIANT_SIZE_LIMIT.

Condiciones de error comunes

Examples

-- Append to a root array
> SELECT try_variant_array_append(parse_json('[1]'), '$', 2)
  [1,2]

-- Append to a nested array
> SELECT try_variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
  {"a":[1,2,3]}

-- Non-array target
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
  NULL

-- Missing path
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
  {"a":1}

-- Invalid path
> SELECT try_variant_array_append(parse_json('[]'), 'invalid', 1)
  Error: INVALID_VARIANT_PATH.