类别：: 数据指标函数

NULL_PERCENT（系统数据指标函数）¶

返回指定表中某列值为 NULL 的百分比。

本主题提供直接调用该函数的语法。要了解如何将该函数与表或视图关联以使其定期运行，请参阅关联 DMF 以自动执行数据质量检查。

语法¶

SNOWFLAKE.CORE.NULL_PERCENT(<query>)

Copy

实参¶

query: 指定一个 SQL 查询，该查询仅投射单个列。

允许的数据类型¶

query 投射的列必须具有以下数据类型之一：

DATE
FLOAT
NUMBER
TIMESTAMP_LTZ
TIMESTAMP_NTZ
TIMESTAMP_TZ
VARCHAR

返回¶

该函数会返回 NUMBER 值。

访问控制要求¶

Associating and running a system DMF requires the USAGE privilege on the system DMF. You can grant the SNOWFLAKE.DATA_METRIC_USER database role to give users the USAGE privilege on all system DMFs. For more information, see Grant the USAGE privilege on system DMFs.

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

示例¶

衡量 SSN 列（即 US 社会安全号码）的 NULL 值的百分比：

SELECT SNOWFLAKE.CORE.NULL_PERCENT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);

Copy

+----------------------------------------------------------------+
| SNOWFLAKE.CORE.NULL_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+----------------------------------------------------------------+
| 1                                                              |
+----------------------------------------------------------------+