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, ou NULL para tipos intermediários incompatíveis.
Sintaxe
try_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.
Se create_if_missing for false, um alvo ausente ou um caminho intermediário permanece variantExpr inalterado.
Argumentos SQL NULL retornam SQL NULL.
A função retorna SQL NULL para tipos intermediários incompatíveis. Para gerar um erro em vez disso, use 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 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.