类别：: LOCAL 架构、表函数

DATA_QUALITY_MONITORING_EXPECTATION_STATUS¶

对于指定对象，每次运行具有期望的数据指标函数 (DMF) 时返回一行。您可以获取每行中的期望状态。

另请参阅：: :doc:`/sql-reference/local/data_quality_monitoring_expectation_status`（LOCAL 视图）

语法¶

DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
  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 的运行）。有关触发器操作的信息，请参阅计划 DMF 运行。
`measurement_time`	TIMESTAMP_LTZ	指标的评估时间。
`table_id`	NUMBER	与 DMF 关联的表的内部/系统生成的标识符。
`table_name`	VARCHAR	与 DMF 关联的表的名称。
`table_schema`	VARCHAR	包含与 DMF 关联的表的架构的名称。
`table_database`	VARCHAR	包含与 DMF 关联的表的数据库的名称。
`metric_id`	NUMBER	DMF 的内部/系统生成的指标标识符。
`metric_name`	VARCHAR	DMF 的名称。
`metric_schema`	VARCHAR	包含 DMF 的架构的名称。
`metric_database`	VARCHAR	包含 DMF 的数据库的名称。
`metric_return_type`	VARCHAR	DMF 的返回类型。
`arguments_ids`	ARRAY	DMF 实参的标识符数组。数组元素的顺序与实参的顺序相同。
`arguments_types`	ARRAY	每个实参的域/类型的数组。数组元素的顺序与实参的顺序相同。目前仅支持 COLUMN 类型实参。
`arguments_names`	ARRAY	DMF 实参的名称的数组。对于列实参，每个元素都是一列的名称。数组元素的顺序与实参的顺序相同。
`reference_id`	VARCHAR	用于唯一标识指标实体引用的 ID，称为关联 ID。
`value`	VARIANT	DMF 评估的结果。
`expectation_name`	VARCHAR	将期望添加到 DMF 与对象之间的关联时为期望指定的名称。
`expectation_id`	VARCHAR	系统生成的标识符。
`expectation_expression`	VARCHAR	期望的布尔表达式。请参阅定义符合期望的内容。
`expectation_violated`	BOOLEAN	如果为 TRUE，则违反了期望。当 `expectation_expression` 计算结果为 FALSE 时，则违反了期望。 NULL 值表示对期望的评估失败。

访问控制要求¶

To access this function, the role in use must have the SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP application role, at a minimum. For other application role options, see 查看数据质量结果. Use the GRANT APPLICATION ROLE command to grant the application role to a role.

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

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

要对架构中的任何对象执行操作，需要对父数据库和架构具有 USAGE 权限。

使用说明¶

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

示例¶

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

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
    REF_ENTITY_NAME => 'my_db.sch1.my_table',
    REF_ENTITY_DOMAIN => 'TABLE'));

Copy