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 Planification de l’exécution de la DMF.
`measurement_time`	TIMESTAMP_LTZ	Heure à laquelle la mesure a été évaluée.
`table_id`	NUMBER	Identificateur interne/généré par le système de la table à laquelle l’adresse DMF est associée.
`table_name`	VARCHAR	Nom de la table à laquelle la DMF est associée.
`table_schema`	VARCHAR	Nom du schéma qui contient la table à laquelle la DMF est associée.
`table_database`	VARCHAR	Nom de la base de données qui contient la table à laquelle la DMF est associée.
`metric_id`	NUMBER	Identificateur généré par le système/interne de la DMF.
`metric_name`	VARCHAR	Nom de l’DMF.
`metric_schema`	VARCHAR	Nom du schéma qui contient la DMF.
`metric_database`	VARCHAR	Nom de la base de données qui contient la DMF.
`metric_return_type`	VARCHAR	Type de retour de la DMF.
`arguments_ids`	ARRAY	Tableau des identificateurs des arguments de la DMF. Les éléments du tableau sont dans le même ordre que les arguments.
`arguments_types`	ARRAY	Tableau du domaine/type de chaque argument de la DMF. Les éléments du tableau sont dans le même ordre que les arguments. Actuellement, seuls les arguments de type COLUMN sont pris en charge.
`arguments_names`	ARRAY	Tableau des noms des arguments de la DMF. Pour les arguments de type colonne, chaque élément est le nom d’une colonne. Les éléments du tableau sont dans le même ordre que les 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	Le résultat de l’évaluation de la DMF.

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