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.

Syntax

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. val se añade como un solo elemento, por lo que añadir un array crea un array anidado.

Los argumentos SQL NULL devuelven SQL NULL.

Tipos intermedios incompatibles o un objetivo no integrado en la matriz elevan VARIANT_PATH_TYPE_MISMATCH. Para devolver SQL NULL en su lugar, utilice try_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 variant_array_append(parse_json('[1, 2, 3]'), '$', 4)
  [1,2,3,4]

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

-- Append an array as a single element
> SELECT variant_array_append(parse_json('[1]'), '$', parse_json('[2, 3]'))
  [1,[2,3]]

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

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