Catégories :: LOCAL, Fonctions de table

DATA_QUALITY_MONITORING_RESULTS¶

Renvoie une ligne pour chaque fonction de métrique de données attribuée à l’objet spécifié, qui inclut le résultat de l’évaluation et d’autres métadonnées de la fonction de métrique de données sur l’objet.

Voir aussi :: Vue DATA_QUALITY_MONITORING_RESULTS (vue LOCAL)

Syntaxe¶

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

Copy

Arguments¶

REF_ENTITY_NAME => 'string'

Nom de l’objet de table sur lequel la fonction de métrique des données est définie.

Le nom entier de l’objet doit être entre guillemets simples.
Si le nom de l’objet est sensible à la casse ou inclut des caractères spéciaux ou des espaces, des guillemets doubles sont nécessaires pour traiter la casse / les caractères. Les guillemets doubles doivent être placés entre guillemets simples, par exemple '"<table_name>"'.

REF_ENTITY_DOMAIN => 'string'

Type d’objet sur lequel la fonction de métrique des données est définie.

Si l’objet est un type de table, utilisez 'TABLE' comme valeur d’argument.

Si l’objet est une vue ou une vue matérialisée, utilisez 'VIEW' comme valeur d’argument.

Pour obtenir une liste des types d’objets pris en charge sur lesquels une fonction de métrique de données, voir Types de tables pris en charge.

Renvoie¶

La fonction renvoie les colonnes suivantes :

Nom de la colonne	Type de données	Description
`scheduled_time`	TIMESTAMP_LTZ	Heure à laquelle la DMF est planifiée pour s’exécuter en fonction de la planification que vous avez définie pour la table ou la vue.
`change_commit_time`	TIMESTAMP_LTZ	Heure à laquelle l’opération de déclenchement de la DMF s’est produite, ou `None` si l’exécution de la DMF n’est pas planifiée par une opération de déclenchement. Pour des informations sur l’opération de déclenchement, voir Planifiez l’exécution de vos DMFs.
`measurement_time`	TIMESTAMP_LTZ	Heure à laquelle la métrique est évaluée.
`table_id`	NUMBER	Identificateur interne/généré par le système de la table à laquelle la règle est associée. Les règles peuvent être associées soit directement à la table, soit à n’importe quelle colonne de la table.
`table_name`	VARCHAR	Nom de la table.
`table_schema`	VARCHAR	Nom du schéma contenant la table.
`table_database`	VARCHAR	Nom de la base de données contenant la table.
`metric_id`	NUMBER	Identificateur interne/généré par le système de la métrique.
`metric_name`	VARCHAR	Nom de la métrique.
`metric_schema`	VARCHAR	Nom du schéma qui contient la métrique.
`metric_database`	VARCHAR	Nom de la base de données qui contient la métrique.
`metric_return_type`	VARCHAR	Type de retour de la métrique.
`arguments_ids`	ARRAY	Tableau contenant des IDs d’arguments de référence utilisés pour évaluer la règle. Les entrées du tableau sont triées en fonction de la position des arguments.
`arguments_types`	ARRAY	Tableau contenant les types des arguments de référence utilisés pour évaluer la règle. Les entrées du tableau sont triées en fonction de la position des arguments. Actuellement, seuls les arguments de type COLUMN sont pris en charge.
`arguments_names`	ARRAY	Tableau contenant les noms des arguments de référence utilisés pour évaluer la règle. Les entrées du tableau sont triées en fonction de la position des arguments.
`reference_id`	VARCHAR	ID permettant d’identifier de manière unique la référence de l’entité de métrique, connu comme l’ID d’association.
`value`	VARIANT	Résultat de l’évaluation.

Exigences en matière de contrôle d’accès¶

Pour accéder à cette fonction, le rôle utilisé doit avoir le rôle d’application SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP, au minimum. Pour d’autres options de rôle d’application, voir Gestion de l’accès aux résultats de la DMF. Utilisez la commande GRANT APPLICATION ROLE pour accorder le rôle d’application à un rôle.

Pour voir les résultats, le rôle utilisé doit également disposer des privilèges suivants :

Les privilèges SELECT ou OWNERSHIP sur l’objet (table ou vue) auquel la fonction de métrique de données est attribuée.
Les privilèges USAGE ou OWNERSHIP sur la fonction de métrique des données.

Notes sur l’utilisation¶

L’erreur se produit si le nom d’objet spécifié n’existe pas ou si l’opérateur de la requête n’est autorisé à voir aucune fonction de métrique des données sur l’objet. Les types d’objets non pris en charge, répertoriés comme REF_ENTITY_DOMAIN, tels que 'stream', renvoient également des erreurs.

Exemples¶

Renvoie une ligne pour chaque fonction de métrique des données affectée à la table nommée 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