SYSTEM$EVALUATE_DATA_QUALITY_EXPECTATIONS¶

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

语法¶

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

Copy

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)

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

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

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

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

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

Copy