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 anexado ao array em path, ou NULL se um valor intermediário tiver um tipo incompatível ou se o alvo não for um array.
Sintaxe
try_variant_array_append ( variantExpr, path, val )
Arguments
-
variantExpr: UmaVARIANTexpressão. -
path: UmaSTRINGexpressão com uma expressão de caminho JSON bem formada que especifica o array alvo. Os índices de array são baseados em zero. -
val: Uma expressão conjectável paraVARIANT.
Returns
Um valor do tipo VARIANT.
Um caminho ausente permanece variantExpr inalterado.
Argumentos SQL NULL retornam SQL NULL.
A função retorna SQL NULL para tipos intermediários incompatíveis ou para um alvo que não seja de array. Para gerar um erro em vez disso, use variant_array_append.
Caminhos malformados aumentam INVALID_VARIANT_PATH, e resultados que excedem o limite de tamanho da variante aumentam VARIANT_SIZE_LIMIT.
Condições de erro comuns
Examples
-- Append to a root array
> SELECT try_variant_array_append(parse_json('[1]'), '$', 2)
[1,2]
-- Append to a nested array
> SELECT try_variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
{"a":[1,2,3]}
-- Non-array target
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
NULL
-- Missing path
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
{"a":1}
-- Invalid path
> SELECT try_variant_array_append(parse_json('[]'), 'invalid', 1)
Error: INVALID_VARIANT_PATH.