Categorias:: Funções de dados semiestruturados e estruturados (Análise)

CHECK_JSON¶

Verifica a validade de um documento JSON. Se a cadeia de caracteres de entrada for um documento JSON válido ou um NULL, a saída é NULL (ou seja, sem erro). Se a entrada não puder ser traduzida para um valor JSON válido, a cadeia de caracteres de saída contém a mensagem de erro.

Sintaxe¶

CHECK_JSON( <string_or_variant_expr> )

Argumentos¶

string_or_variant_expr

O valor da VARIANT ou da cadeia de caracteres (ou expressão) a ser verificada.

Se a expressão for do tipo VARIANT, ela deve conter uma cadeia de caracteres.

Exemplos¶

Criar uma tabela e inserir alguns valores VARCHAR e VARIANT:

CREATE TABLE sample_json_table (ID INTEGER, varchar1 VARCHAR, variant1 VARIANT);
INSERT INTO sample_json_table (ID, varchar1) VALUES 
    (1, '{"ValidKey1": "ValidValue1"}'),
    (2, '{"Malformed -- Missing value": }'),
    (3, NULL)
    ;
UPDATE sample_json_table SET variant1 = varchar1::VARIANT;

Use a função CHECK_JSON para verificar a validade das cadeias de caracteres potenciais compatíveis com JSON em uma coluna VARCHAR:

SELECT ID, CHECK_JSON(varchar1), varchar1 FROM sample_json_table ORDER BY ID;
+----+----------------------+----------------------------------+
| ID | CHECK_JSON(VARCHAR1) | VARCHAR1                         |
|----+----------------------+----------------------------------|
|  1 | NULL                 | {"ValidKey1": "ValidValue1"}     |
|  2 | misplaced }, pos 32  | {"Malformed -- Missing value": } |
|  3 | NULL                 | NULL                             |
+----+----------------------+----------------------------------+

Use a função CHECK_JSON para verificar a validade das cadeias de caracteres potenciais compatíveis com JSON em uma coluna VARIANT:

SELECT ID, CHECK_JSON(variant1), variant1 FROM sample_json_table ORDER BY ID;
+----+----------------------+--------------------------------------+
| ID | CHECK_JSON(VARIANT1) | VARIANT1                             |
|----+----------------------+--------------------------------------|
|  1 | NULL                 | "{\"ValidKey1\": \"ValidValue1\"}"   |
|  2 | misplaced }, pos 32  | "{\"Malformed -- Missing value\": }" |
|  3 | NULL                 | NULL                                 |
+----+----------------------+--------------------------------------+