类别：

LOCAL、表函数

DATA_QUALITY_MONITORING_RESULTS

为分配给指定对象的每个数据指标函数返回一行，其中包括对象上数据指标函数的评估结果和其他元数据。

另请参阅：

:doc:`/sql-reference/local/data_quality_monitoring_results`（LOCAL 视图）

语法

DATA_QUALITY_MONITORING_RESULTS(
  REF_ENTITY_NAME => '<string>' ,
  REF_ENTITY_DOMAIN => '<string>'
  )
Copy

实参

REF_ENTITY_NAME => 'string'

设置了数据指标函数的表对象的名称。

  • 整个对象名称必须放在单引号内。

  • 如果对象名称区分大小写或包含任何特殊字符或空格，则需要使用双引号来处理大小写/字符。双引号必须放在单引号内，例如 '"<table_name>"'。

REF_ENTITY_DOMAIN => 'string'

设置了数据指标函数的对象类型。

如果对象是一个表格，则使用 'TABLE' 作为实参值。

如果对象是一个视图或者物化视图，则使用 'VIEW' 作为实参值。

有关可在其上设置数据指标函数的受支持对象类型的列表，请参阅 支持的表类型。

返回

该函数返回以下列：

列名称

数据类型

描述

scheduled_time

TIMESTAMP_LTZ

根据您为表或视图设置的计划，计划 DMF 的运行时间。

change_commit_time

TIMESTAMP_LTZ

DMF 触发器操作发生的时间，或者为 :code:`None`（如果未计划由触发器操作来引发 DMF 的运行）。

有关触发器操作的信息，请参阅 计划 DMFs 的运行。

measurement_time

TIMESTAMP_LTZ

评估指标的时间。

table_id

NUMBER

关联规则的表的内部标识符或系统生成的标识符。规则可以直接与表相关联，也可以与表中的任何列相关联。

table_name

VARCHAR

表的名称。

table_schema

VARCHAR

包含表的架构的名称。

table_database

VARCHAR

包含表的数据库的名称。

metric_id

NUMBER

内部/系统生成的指标标识符。

metric_name

VARCHAR

指标的名称。

metric_schema

VARCHAR

包含指标的架构的名称。

metric_database

VARCHAR

包含指标的数据库的名称。

metric_return_type

VARCHAR

指标的返回类型。

arguments_ids

ARRAY

一个数组，包含用于评估规则的参考实参的 IDs。数组的条目按实参的位置排序。

arguments_types

ARRAY

一个数组，包含用于评估规则的参考实参的类型。数组的条目按实参的位置排序。

目前仅支持 COLUMN 类型实参。

arguments_names

ARRAY

一个数组，包含用于评估规则的参考实参的名称。数组的条目按实参的位置排序。

reference_id

VARCHAR

用于唯一标识指标实体引用的 ID，称为关联 ID。

value

VARIANT

评估的结果。

访问控制要求

要访问此函数，所使用的角色必须至少具有 SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP 应用程序角色。有关其他应用程序角色选项，请参阅 管理对 DMF 结果的访问权限。使用 GRANT APPLICATION ROLE 命令将应用程序角色授予一个角色。

要查看结果，所使用的角色还必须具有以下权限：

  • 数据指标函数分配给的对象（表或视图）上的 SELECT 或 OWNERSHIP 或权限。

  • 数据指标函数的 USAGE 或 OWNERSHIP 权限。

使用说明

如果指定的对象名称不存在，或者查询操作员未被授权查看对象上的任何数据指标函数，则会产生错误。作为 REF_ENTITY_DOMAIN 列出的不支持的对象类型，如 'stream'，也会返回错误。

示例

为分配给名为 my_table 的表的每个数据指标函数返回一行：

USE DATABASE SNOWFLAKE;
USE SCHEMA LOCAL;
SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_RESULTS(
    REF_ENTITY_NAME => 'my_db.my_schema.my_table',
    REF_ENTITY_DOMAIN => 'table'));
Copy
语言: 中文