variant_set Función

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

Devuelve variantExpr con val inserted o set en path.

Syntax

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.

Reemplazar un elemento del array no desplaza a otros elementos.

Si create_if_missing es true, se crean campos faltantes y contenedores intermedios. Un índice igual a la longitud del array añade val. Un índice más grande rellena el array con valores nulos variantes antes de añadir val.

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

Los argumentos SQL NULL devuelven SQL NULL.

Los tipos intermedios incompatibles generan VARIANT_PATH_TYPE_MISMATCH, independientemente de create_if_missing. Para devolver SQL NULL en su lugar, utilice try_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 variant_set(parse_json('{"a": 1}'), '$.a', 2)
  {"a":2}

-- Create a missing path
> SELECT variant_set(parse_json('{}'), '$.a.b', 1)
  {"a":{"b":1}}

-- Replace an array element
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[1]', 'z')
  ["a","z","c"]

-- Append at the array length
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[3]', 'z')
  ["a","b","c","z"]

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

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