Categories:: LOCAL , Table functions

DATA_QUALITY_MONITORING_RESULTS¶

Returns a row for each data metric function assigned to the specified object, which includes the evaluation result and other metadata of the data metric function on the object.

See also:: DATA_QUALITY_MONITORING_RESULTS view (LOCAL view)

Syntax¶

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

Copy

Arguments¶

REF_ENTITY_NAME => 'string'

The name of the table object on which the data metric function is set.

The entire object name must be enclosed in single quotes.
If the object name is case-sensitive or includes any special characters or spaces, double quotes are required to process the case/characters. The double quotes must be enclosed within the single quotes, such as '"<table_name>"'.

REF_ENTITY_DOMAIN => 'string'

The object type on which the data metric function is set.

If the object is a kind of table, use 'TABLE' as the argument value.

If the object is a view or materialized view, use 'VIEW' as the argument value.

For a list of supported object types on which a data metric function can be set, see Supported table kinds.

Returns¶

The function returns the following columns:

Column name	Data type	Description
`scheduled_time`	TIMESTAMP_LTZ	The time the DMF is scheduled to run based on the schedule that you set for the table or view.
`change_commit_time`	TIMESTAMP_LTZ	The time the DMF trigger operation occurred, or `None` if the DMF is not scheduled to run by a trigger operation. For information about the trigger operation, see Schedule the DMF to run.
`measurement_time`	TIMESTAMP_LTZ	The time at which the metric is evaluated.
`table_id`	NUMBER	Internal/system-generated identifier of the table where the rule is associated. Rules could either be associated directly to the table or to any column of the table.
`table_name`	VARCHAR	Name of the table.
`table_schema`	VARCHAR	Name of the schema name that contains the table.
`table_database`	VARCHAR	Name of the database that contains the table.
`metric_id`	NUMBER	Internal/system-generated identifier of the metric.
`metric_name`	VARCHAR	Name of the metric.
`metric_schema`	VARCHAR	Name of the schema that contains of the metric.
`metric_database`	VARCHAR	Name of the database that contains the metric.
`metric_return_type`	VARCHAR	Return type of the metric.
`arguments_ids`	ARRAY	An array that contains IDs of reference arguments used to evaluate the rule. Entries of the array are ordered by the positions of arguments.
`arguments_types`	ARRAY	An array that contains types of reference arguments used to evaluate the rule. Entries of the array are ordered by the positions of arguments. Currently only supports COLUMN type arguments.
`arguments_names`	ARRAY	An array that contains names of reference arguments used to evaluate the rule. Entries of the array are ordered by the positions of arguments.
`reference_id`	VARCHAR	The ID to uniquely identify the metric entity reference, known as the association ID.
`value`	VARIANT	The result of the evaluation.

Access control requirements¶

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 Managing access to the DMF results. Use the GRANT APPLICATION ROLE command to grant the application role to a role.

To view results, the role in use must also have the following privileges:

The SELECT or OWNERSHIP privileges on the object (table or view) to which the data metric function is assigned.
The USAGE or OWNERSHIP privileges on the data metric function.

Usage notes¶

Errors occur if the specified object name does not exist or if the query operator is not authorized to view any data metric function on the object. Unsupported object types listed as the REF_ENTITY_DOMAIN, such as 'stream', also return errors.

Examples¶

Return a row for each data metric function assigned to the table named 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