类别：: Information Schema、表函数

DATA_METRIC_FUNCTION_EXPECTATIONS¶

返回账户中存在的有关期望的信息。

语法¶

DATA_METRIC_FUNCTION_EXPECTATIONS(
  [ METRIC_NAME => '<string>' ]
  [, REF_ENTITY_NAME => '<string>' ]
  [, REF_ENTITY_DOMAIN => '<string>' ]
)

Copy

实参¶

METRIC_NAME => 'string'

指定系统或自定义数据指标函数 (DMF) 的名称。此函数会返回添加到对象与指定 DMF 之间关联的期望。

REF_ENTITY_NAME => 'string'

指定 DMFs 与之关联的对象的名称。返回添加到与对象关联的 DMF 的期望。如果已指定，则还必须指定 REF_ENTITY_DOMAIN。

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

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

REF_ENTITY_DOMAIN => 'string'

REF_ENTITY_NAME 的对象类型。

如果对象是任何表类型，则使用 table 作为实参值。
如果对象是一个视图或者物化视图，则使用 view 作为实参值。

输出¶

该函数返回以下列：

列名称	数据类型	描述
`metric_database_name`	VARCHAR	DMF 所在的数据库。
`metric_schema_name`	VARCHAR	DMF 所在的架构。
`metric_name`	VARCHAR	DMF 的名称。
`metric_signature`	VARCHAR	DMF 的签名。
`metric_data_type`	VARCHAR	DMF 返回的数据类型。
`ref_entity_database_name`	VARCHAR	与 DMF 关联的对象的数据库。
`ref_entity_schema_name`	VARCHAR	与 DMF 关联的对象的架构。
`ref_entity_name`	VARCHAR	与 DMF 关联的对象的名称。
`ref_entity_domain`	VARCHAR	与 DMF 关联的对象的类型。
`ref_arguments`	ARRAY	传递给 DMF 的实参。
`ref_id`	VARCHAR	系统生成的标识符。
`expectation_id`	VARCHAR	系统生成的期望标识符。
`expectation_name`	VARCHAR	用户在将期望添加到 DMF 关联时，为期望指定的名称。
`expectation_expression`	VARCHAR	期望的布尔表达式。请参阅定义符合期望的内容。

示例¶

返回对特定对象的期望。

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      REF_ENTITY_NAME => 'my_table',
      REF_ENTITY_DOMAIN => 'table'));

Copy

返回对特定 DMF 的期望。

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      METRIC_NAME => 'SNOWFLAKE.CORE.NULL_COUNT'));

Copy

返回对对象与 DMF 之间特定关联的期望。

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      METRIC_NAME => 'SNOWFLAKE.CORE.NULL_COUNT',
      REF_ENTITY_NAME => 'my_table',
      REF_ENTITY_DOMAIN => 'table'));

Copy