Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
SQL
Runtime 19 e superior
Retorna variantExpr com val inserido como campo ou elemento de array em path.
Sintaxe
variant_insert ( variantExpr, path, val )
Arguments
-
variantExpr: UmaVARIANTexpressão. -
path: UmaSTRINGexpressão com uma expressão de caminho JSON bem formada. Os índices de array são baseados em zero. -
val: Uma expressão conjectável paraVARIANT.
Returns
Um valor do tipo VARIANT.
A inserção de array desloca os elementos subsequentes para a direita. Um índice igual ao comprimento do array acrescenta val. Um índice maior preenche o array com nulos variantes antes da inserção.
Objetos intermediários ou arrays ausentes são criados de acordo com o próximo segmento de caminho.
Argumentos SQL NULL retornam SQL NULL.
Campos duplicados de objetos levantam VARIANT_DUPLICATE_KEY. Tipos intermediários incompatíveis aumentam VARIANT_PATH_TYPE_MISMATCH. Para retornar SQL NULL em vez disso, use try_variant_insert.
Caminhos malformados ou o caminho $ da raiz aumentam INVALID_VARIANT_PATH, e resultados que excedem o limite de tamanho da variante aumentam VARIANT_SIZE_LIMIT.
Condições de erro comuns
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.