JSON_PATH_EXISTS (Lakehouse v1)

Verifica se um caminho especificado existe em dados JSON.

Sintaxe do Analyze

func.json_path_exists(<json_data>, <json_path_expression)

Exemplos do Analyze

func.json_path_exists(parse_json('{"a": 1, "b": 2}'), '$.a ? (@ == 1)'), func.json_path_exists(parse_json('{"a": 1, "b": 2}'), '$.a ? (@ > 1)')
┌─────────────────────────────┐
│       Item 1   │  Item 2    │
├────────────────┼────────────┤
│       True     │  False     │
└─────────────────────────────┘

Sintaxe SQL

JSON_PATH_EXISTS(<json_data>, <json_path_expression>)

• json_data: especifica os dados JSON em que você deseja pesquisar. Pode ser um objeto JSON ou um array.

• json_path_expression: especifica o caminho, a partir da raiz dos dados JSON representada por $, que você deseja verificar nos dados JSON. Você também pode incluir condições na expressão, usando @ para se referir ao nó ou elemento atual que está sendo avaliado, para filtrar os resultados.

Tipo de retorno

A função retorna:

• true se o caminho JSON especificado (e as condições, se houver) existir nos dados JSON.
• false se o caminho JSON especificado (e as condições, se houver) não existir nos dados JSON.
• NULL se json_data ou json_path_expression for NULL ou inválido.

Exemplos de SQL

SELECT JSON_PATH_EXISTS(parse_json('{"a": 1, "b": 2}'), '$.a ? (@ == 1)');

----
true


SELECT JSON_PATH_EXISTS(parse_json('{"a": 1, "b": 2}'), '$.a ? (@ > 1)');

----
false

SELECT JSON_PATH_EXISTS(NULL, '$.a');

----
NULL

SELECT JSON_PATH_EXISTS(parse_json('{"a": 1, "b": 2}'), NULL);

----
NULL