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 como campo o elemento de matriz en path.
Syntax
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.
La inserción de matriz desplaza los elementos posteriores hacia la derecha. Un índice igual a la longitud del array añade val. Un índice más grande rellena el array con variantes nulas antes de insertarlo.
Los objetos o matrices intermedios faltantes se crean según el siguiente segmento de trazado.
Los argumentos SQL NULL devuelven SQL NULL.
Los campos duplicados de objetos aumentan VARIANT_DUPLICATE_KEY. Los tipos intermedios incompatibles generan VARIANT_PATH_TYPE_MISMATCH. Para devolver SQL NULL en su lugar, utilice try_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 variant_insert(parse_json('{"a": 1}'), '$.b', 2)
{"a":1,"b":2}
-- Create a missing path
> SELECT variant_insert(parse_json('{}'), '$.a[0]', 1)
{"a":[1]}
-- Insert an array element
> SELECT variant_insert(parse_json('["a", "b", "c"]'), '$[1]', 'z')
["a","z","b","c"]
-- Pad an array with variant nulls
> SELECT variant_insert(parse_json('["a", "b"]'), '$[5]', 'z')
["a","b",null,null,null,"z"]
-- Insert a variant null
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', parse_json('null'))
{"a":1,"b":null}
-- SQL NULL argument
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', CAST(NULL AS VARIANT))
NULL
-- Duplicate object field
> SELECT variant_insert(parse_json('{"a": 1}'), '$.a', 2)
Error: VARIANT_DUPLICATE_KEY.