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 inserted o set en path.
Syntax
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.
Reemplazar un elemento del array no desplaza a otros elementos.
Si create_if_missing es true, se crean campos faltantes y contenedores intermedios. Un índice igual a la longitud del array añade val. Un índice más grande rellena el array con valores nulos variantes antes de añadir val.
Si create_if_missing es false, un destino faltante o un camino intermedio queda variantExpr sin cambios.
Los argumentos SQL NULL devuelven SQL NULL.
Los tipos intermedios incompatibles generan VARIANT_PATH_TYPE_MISMATCH, independientemente de create_if_missing. Para devolver SQL NULL en su lugar, utilice try_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 variant_set(parse_json('{"a": 1}'), '$.a', 2)
{"a":2}
-- Create a missing path
> SELECT variant_set(parse_json('{}'), '$.a.b', 1)
{"a":{"b":1}}
-- Replace an array element
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[1]', 'z')
["a","z","c"]
-- Append at the array length
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[3]', 'z')
["a","b","c","z"]
-- Missing path with creation disabled
> SELECT variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
{"a":1}
-- Incompatible path
> SELECT variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
Error: VARIANT_PATH_TYPE_MISMATCH.