Todos os produtos
Search
Central de documentação

Realtime Compute for Apache Flink:PARSE_JSON

Última atualização: Jun 27, 2026

Converte uma string JSON em um valor VARIANT.

Nota

Esta função tem suporte apenas no Ververica Runtime (VVR) 11.1.0 ou posterior.

Sintaxe

VARIANT PARSE_JSON(VARCHAR jsonStr [, BOOLEAN allowDuplicateKeys])

Argumentos

Argumento

Tipo de dados

Descrição

jsonStr

VARCHAR

String JSON a analisar.

allowDuplicateKeys

BOOLEAN

(Opcional) Defina se chaves duplicadas são permitidas. true: retém o valor da última chave duplicada. false (padrão): gera erro se houver chaves duplicadas.

Notas de uso

  • Se jsonStr for NULL, a função retornará NULL.

PARSE_JSON vs. TRY_PARSE_JSON

Função

Tratamento de erros

Valor de retorno para JSON inválido

Quando usar

PARSE_JSON

Gera erro

Erro

Validação rigorosa de entrada necessária

TRY_PARSE_JSON

Tolerante a erros

NULL

Entrada inválida aceitável

Exemplos

Uso básico

Tabela de entrada T1:

jsonString (VARCHAR)

{"k": "v1", "k2": 1}

SELECT PARSE_JSON(jsonString) AS v
FROM T1;

Resultado:

v (VARIANT)

{"k": "v1", "k2": 1}

Tratamento de chaves duplicadas

Por padrão, PARSE_JSON gera erro ao detectar chaves duplicadas:

SELECT PARSE_JSON('{"a": "123", "b": "456", "a": "789"}') AS v;

Para reter o último valor de cada chave duplicada, defina allowDuplicateKeys como true:

SELECT PARSE_JSON('{"a": "123", "b": "456", "a": "789"}', true) AS v;