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 insertado o establecido en path, o NULL para tipos intermedios incompatibles.
Syntax
try_variant_set ( variantExpr, path, val [, create_if_missing] )
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. -
create_if_missing: Una expresión constante opcional (plegableBOOLEAN). Sitrue, crea campos faltantes, elementos de matriz y objetos o matrices intermedios a lo largopathde . El valor predeterminado estrue.
Returns
Valor de tipo VARIANT.
Si create_if_missing es false, un destino faltante o un camino intermedio queda variantExpr sin cambios.
Los argumentos SQL NULL devuelven SQL NULL.
La función devuelve SQL NULL para tipos intermedios incompatibles. Para generar un error en su lugar, usa 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 try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
{"a":99}
-- Incompatible path
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
NULL
-- Missing path with creation disabled
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
{"a":1}
-- Invalid root path
> SELECT try_variant_set(parse_json('{}'), '$', 1)
Error: INVALID_VARIANT_PATH.