类别：

数据指标函数

UNIQUE_COUNT（系统数据指标函数）

返回表中指定列的唯一非 NULL 值总数。

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

语法

SNOWFLAKE.CORE.UNIQUE_COUNT(<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 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

手动调用系统 DMF 时，无需指定所使用的允许数据类型。只需为要测量的列指定查询。Snowflake 将函数允许的数据类型与列的数据类型进行匹配。

示例

测量 SSN 列（即，US 社会安全号码）的唯一非 NULL 值的数量：

SELECT SNOWFLAKE.CORE.UNIQUE_COUNT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);
Copy
+------------------------------------------------------------------+
| SNOWFLAKE.CORE.UNIQUE_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+------------------------------------------------------------------+
| 42                                                               |
+------------------------------------------------------------------+
语言: 中文