类别：: 条件表达式函数、半结构化和结构化数据函数（类型谓词）

IS_NULL_VALUE¶

如果其 VARIANT 实参为 JSON null 值，则返回 true。

重要

JSON null 值与 SQL NULL 值不同。

此函数仅对 JSON null 值返回 true，而不对 SQL NULL 值返回 true。在下面示例中，第一行和第三行中出现差异。

缺少的 JSON 子列将被转换为 SQL NULL 值，IS_NULL_VALUE 将为此返回 NULL。以下示例中的第 4 列显示了这一点。

请注意，此函数不应与 IS [ NOT ] NULL 混淆。

另请参阅：: IS_<object_type>

语法¶

IS_NULL_VALUE( <variant_expr> )

Copy

返回¶

返回值的数据类型是 BOOLEAN。

示例¶

该示例演示了 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