SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS¶

返回数据指标函数 (DMFs) 与表之间关联的期望，包括当前是否违反该期望。

语法¶

SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS(
  REF_ENTITY_NAME  => '<object>'
  [ , SKIP_SUSPENDED_DMF => { TRUE | FALSE } ] )

REF_ENTITY_NAME => 'object'

至少包含一个具有一个或多个期望的 DMF 的表或视图的名称。必须完全限定。

SKIP_SUSPENDED_DMF => { TRUE | FALSE }

如果设置为 TRUE，则该函数不返回为 object 和已暂停 DMFs 之间的关联定义的期望。已暂停 DMF 不按对象的指定时间表运行。

默认：TRUE

返回包含以下列的表：


列	数据类型	描述
`metric_database`	VARCHAR	包含 DMF 的数据库的名称。
`metric_schema`	VARCHAR	包含 DMF 的架构的名称。
`metric_name`	VARCHAR	DMF 的名称。
`expectation_name`	VARCHAR	用户在将期望添加到 DMF 和表之间的关联时分配的名称。
`expectation_id`	NUMBER	系统生成的标识符。
`expectation_expression`	VARCHAR	期望的布尔表达式。请参阅定义符合期望的内容。
`arguments`	ARRAY	与 DMF 关联的列。
`value`	VARIANT	DMF 评估的结果。
`expectation_violated`	BOOLEAN	如果为 TRUE，则违反了期望。当 `expectation_expression` 计算结果为 FALSE 时，则违反了期望。

用于执行此操作的角色必须至少具有以下权限：


权限	对象	备注
SELECT	表或视图
USAGE	数据指标函数 (DMF)

对架构中的对象进行操作至少需要父数据库的一项权限和父架构的一项权限。

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

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

返回对 DMFs AND 表 t1 之间关联的期望。执行 DMFs 以确定当前是否违反了预期。

SELECT *
  FROM TABLE(SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS(
      REF_ENTITY_NAME => 'my_db.sch.t1'));