Categorias:

Funções de expressão condicional , Funções de dados semiestruturados e estruturados (Predicados de tipo)

IS_NULL_VALUE

Retorna True se seu argumento VARIANT for um valor JSON nulo.

Importante

O valor JSON nulo é distinto do valor SQL NULL.

Esta função retorna True somente para valores nulos JSON, não valores SQL NULL. A diferença é mostrada na primeira e terceira linhas no exemplo abaixo.

Uma subcoluna ausente JSON será convertida em um valor SQL NULL, para a qual IS_NULL_VALUE retornará NULL. A 4ª coluna do exemplo abaixo mostra isto.

Note que esta função não deve ser confundida com IS [ NOT ] NULL.

Consulte também:

IS_<tipo_de_objeto>

Sintaxe

IS_NULL_VALUE( <variant_expr> )
Copy

Retornos

O tipo de dados do valor retornado é BOOLEAN.

Exemplos

Isto demonstra a função IS_NULL_VALUE:

SELECT v, v:a, IS_NULL_VALUE(v:a), IS_NULL_VALUE(v:no_such_field)
    FROM
        (SELECT parse_json(column1) AS v
         FROM VALUES
             ('{"a": null}'),
             ('{"a": "foo"}'),
             (NULL)
        );
+--------------+-------+--------------------+--------------------------------+
| V            | V:A   | IS_NULL_VALUE(V:A) | IS_NULL_VALUE(V:NO_SUCH_FIELD) |
|--------------+-------+--------------------+--------------------------------|
| {            | null  | True               | NULL                           |
|   "a": null  |       |                    |                                |
| }            |       |                    |                                |
| {            | "foo" | False              | NULL                           |
|   "a": "foo" |       |                    |                                |
| }            |       |                    |                                |
| NULL         | NULL  | NULL               | NULL                           |
+--------------+-------+--------------------+--------------------------------+
Copy