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.
Sintaxe
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.
val é adicionado como um único elemento, portanto anexar um array cria um array aninhado.
Argumentos SQL NULL retornam SQL NULL.
Tipos intermediários incompatíveis ou um alvo não relacionado ao array eleva VARIANT_PATH_TYPE_MISMATCH. Para retornar SQL NULL em vez disso, use try_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 variant_array_append(parse_json('[1, 2, 3]'), '$', 4)
[1,2,3,4]
-- Append to a nested array
> SELECT variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
{"a":[1,2,3]}
-- Append an array as a single element
> SELECT variant_array_append(parse_json('[1]'), '$', parse_json('[2, 3]'))
[1,[2,3]]
-- Missing path
> SELECT variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
{"a":1}
-- Non-array target
> SELECT variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
Error: VARIANT_PATH_TYPE_MISMATCH.