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 la opción insertada val en path, o NULL para campos de objeto duplicados o tipos intermedios incompatibles.
Syntax
try_variant_insert ( variantExpr, path, val )
Argumentos
-
variantExpr: UnaVARIANTexpresión. -
path: UnaSTRINGexpresió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 aVARIANT.
Returns
Valor de tipo VARIANT.
Los argumentos SQL NULL devuelven SQL NULL.
La función devuelve SQL NULL para campos de objeto duplicados o tipos intermedios incompatibles. Para generar un error en su lugar, usa variant_insert.
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
-- Insert an object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.b', 2)
{"a":1,"b":2}
-- Duplicate object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a', 2)
NULL
-- Incompatible path
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a.b', 2)
NULL
-- Invalid root path
> SELECT try_variant_insert(parse_json('{}'), '$', 1)
Error: INVALID_VARIANT_PATH.