类别：: 数据指标函数

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

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

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

语法¶

SNOWFLAKE.CORE.NULL_PERCENT(<query>)

Copy

实参¶

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

允许的数据类型¶

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

DATE
FLOAT
NUMBER
TIMESTAMP_LTZ
TIMESTAMP_NTZ
TIMESTAMP_TZ
VARCHAR

返回¶

该函数会返回 NUMBER 值。

访问控制要求¶

关联和运行系统 DMF 需要系统 DMF 的 USAGE 权限。您可以授予 SNOWFLAKE.DATA_METRIC_USER 数据库角色，以便为用户提供所有系统 DMFs 的 USAGE 权限。有关更多信息，请参阅授予系统 DMFs 的 USAGE 权限。

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

有关对安全对象执行 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                                                              |
+----------------------------------------------------------------+