Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a:
SQL
Runtime 19 y superior
Devuelve variantExpr con val añadido al array en path.
Syntax
variant_array_append ( variantExpr, path, val )
Argumentos
-
variantExpr: UnaVARIANTexpresión. -
path: UnaSTRINGexpresió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 aVARIANT.
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.