类别：: 数据指标函数

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

返回时间戳列的最大值与数据指标函数运行时的计划时间之间的差值（秒）。

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

语法¶

SNOWFLAKE.CORE.FRESHNESS(<query>)

Copy

实参¶

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

允许的数据类型¶

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

DATE
TIMESTAMP_LTZ
TIMESTAMP_TZ

返回¶

该函数返回一个数据类型为 NUMBER 的标量值。

访问控制要求¶

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

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

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

示例¶

通过测量 TIMESTAMP 列来确定表中数据的新鲜度，300 秒或 5 分钟：

SELECT SNOWFLAKE.CORE.FRESHNESS(
  SELECT
    timestamp
  FROM hr.tables.empl_info
) < 300;

Copy

+---------------------------------------------------------------------+
| SNOWFLAKE.CORE.FRESHNESS(SELECT timestamp FROM hr.tables.empl_info) |
+---------------------------------------------------------------------+
| True                                                                |
+---------------------------------------------------------------------+