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 ou definido em path.
Sintaxe
variant_set ( variantExpr, path, val [, create_if_missing] )
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. -
create_if_missing: Uma expressão constante opcional (dobrávelBOOLEAN). Setrue, cria campos ausentes, elementos de array e objetos ou arrays intermediários ao longopathde . O padrão étrue.
Returns
Um valor do tipo VARIANT.
Substituir um elemento do array não desloca outros elementos.
Se create_if_missing for true, campos ausentes e contêineres intermediários são criados. Um índice igual ao comprimento do array acrescenta val. Um índice maior preenche o array com variantes nulas antes de adicionar val.
Se create_if_missing for false, um alvo ausente ou um caminho intermediário permanece variantExpr inalterado.
Argumentos SQL NULL retornam SQL NULL.
Tipos intermediários incompatíveis levantam VARIANT_PATH_TYPE_MISMATCH, independentemente de create_if_missing. Para retornar SQL NULL em vez disso, use try_variant_set.
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
-- 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.