try_variant_set Función

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

Devuelve variantExpr con val insertado o establecido en path, o NULL para tipos intermedios incompatibles.

Syntax

try_variant_set ( variantExpr, path, val [, create_if_missing] )

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.
  • create_if_missing: Una expresión constante opcional (plegable BOOLEAN ). Si true, crea campos faltantes, elementos de matriz y objetos o matrices intermedios a lo largo pathde . El valor predeterminado es true.

Returns

Valor de tipo VARIANT.

Si create_if_missing es false, un destino faltante o un camino intermedio queda variantExpr sin cambios.

Los argumentos SQL NULL devuelven SQL NULL.

La función devuelve SQL NULL para tipos intermedios incompatibles. Para generar un error en su lugar, usa variant_set.

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

-- Replace an object field
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
  {"a":99}

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

-- Missing path with creation disabled
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
  {"a":1}

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