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 a VARIANT contendo apenas os campos e elementos do array selecionados variantExpr pelos caminhos especificados.
Sintaxe
variant_pick ( variantExpr, path1 [, path2, ...] )
Arguments
-
variantExpr: UmaVARIANTexpressão. -
path1,path2, ...: Uma ou maisSTRINGexpressões com expressões de caminho JSON bem formadas que especificam os caminhos a serem mantidos. Os índices de array são baseados em zero.
Returns
Um valor do tipo VARIANT.
Campos e elementos selecionados mantêm sua estrutura principal. Os arrays contêm apenas elementos selecionados, em sua ordem original.
Ordem de caminhos e duplicados não afetam o resultado. Selecionar um pai ou mãe inclui todos os seus filhos. O caminho $ raiz seleciona o valor inteiro.
Campos ausentes, índices fora de faixa e tipos intermediários incompatíveis são ignorados. Sem correspondências, as entradas de objeto e array retornam {} e [], respectivamente. Escalares e nulos variantes permanecem inalterados.
Se variantExpr for SQL NULL, o resultado é SQL NULL. Caminhos SQL NULL são pulados.
Caminhos deformados levantam INVALID_VARIANT_PATH.
Condições de erro comuns
Examples
-- Select object fields
> SELECT variant_pick(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
{"a":1,"c":3}
-- Select a nested field
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}, "d": 3}'), '$.a.b')
{"a":{"b":1}}
-- Preserve array order and ignore duplicate paths
> SELECT variant_pick(parse_json('[10, 20, 30, 40]'), '$[2]', '$[0]', '$[2]')
[10,30]
-- Overlapping paths
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}}'), '$.a.b', '$.a')
{"a":{"b":1,"c":2}}
-- Missing path
> SELECT variant_pick(parse_json('{"a": {"b": 1}}'), '$.a.missing')
{}
-- Skip a SQL NULL path
> SELECT variant_pick(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
{"a":1}