Todos os produtos
Search
Central de documentação

Realtime Compute for Apache Flink:TRY_PARSE_JSON

Última atualização: Jun 27, 2026

Versão especial da função PARSE_JSON que retorna NULL em vez de gerar erro quando a análise falha.

Limites

Compatível apenas com o Ververica Runtime (VVR) 11.1.0 ou posterior.

Sintaxe

VARIANT TRY_PARSE_JSON(VARCHAR jsonStr [, BOOLEAN allowDuplicateKeys])

Argumentos

Argumento

Tipo de dados

Descrição

jsonStr

VARCHAR

String JSON para análise.

allowDuplicateKeys

BOOLEAN

(Opcional) Indica se chaves duplicadas são permitidas na string JSON. true: mantém o último valor de cada chave duplicada. false (padrão): retorna NULL caso existam chaves duplicadas.

Retorno

Retorna um valor VARIANT contendo um documento JSON.

Retorna NULL nas seguintes situações:

  • A entrada jsonStr é NULL.

  • A string JSON é inválida e não pode ser analisada.

  • allowDuplicateKeys é false (padrão) e a string JSON contém chaves duplicadas.

Comparação entre PARSE_JSON e TRY_PARSE_JSON

Função

Mecanismo de tratamento de erros

Valor de retorno para entrada JSON inválida

Cenários adequados

PARSE_JSON

Gera erros explicitamente.

Retorna um erro.

Validação rigorosa de entrada.

TRY_PARSE_JSON

Tolerante a erros.

Retorna NULL.

Tolerância a entradas inválidas.

Exemplo

A tabela T1 contém os seguintes dados de teste:

jsonString (VARCHAR)

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

{

Execute a seguinte consulta:

SELECT TRY_PARSE_JSON(jsonString) AS v
FROM T1;

Resultados:

v (VARIANT)

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

NULL

A segunda linha contém JSON inválido ({), portanto TRY_PARSE_JSON retorna NULL. O uso de PARSE_JSON causaria falha na consulta com um erro.