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, o NULL si un valor intermedio tiene un tipo incompatible o el destino no es un array.
Syntax
try_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.
Los argumentos SQL NULL devuelven SQL NULL.
La función devuelve SQL NULL para tipos intermedios incompatibles o para un destino que no sea de la matriz. Para generar un error en su lugar, usa 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 try_variant_array_append(parse_json('[1]'), '$', 2)
[1,2]
-- Append to a nested array
> SELECT try_variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
{"a":[1,2,3]}
-- Non-array target
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
NULL
-- Missing path
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
{"a":1}
-- Invalid path
> SELECT try_variant_array_append(parse_json('[]'), 'invalid', 1)
Error: INVALID_VARIANT_PATH.