try_variant_insert Función

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

Devuelve variantExpr la opción insertada val en path, o NULL para campos de objeto duplicados o tipos intermedios incompatibles.

Syntax

try_variant_insert ( variantExpr, path, val )

Argumentos

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

Returns

Valor de tipo VARIANT.

Los argumentos SQL NULL devuelven SQL NULL.

La función devuelve SQL NULL para campos de objeto duplicados o tipos intermedios incompatibles. Para generar un error en su lugar, usa variant_insert.

Los trazados mal formados o el trazado $ raíz 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

-- Insert an object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.b', 2)
  {"a":1,"b":2}

-- Duplicate object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a', 2)
  NULL

-- Incompatible path
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a.b', 2)
  NULL

-- Invalid root path
> SELECT try_variant_insert(parse_json('{}'), '$', 1)
  Error: INVALID_VARIANT_PATH.