Catégories :: Schéma LOCAL , Fonctions de table

DATA_QUALITY_MONITORING_EXPECTATION_STATUS¶

Pour un objet spécifié, renvoie une ligne à chaque fois qu’une fonction de métrique des données (DMF) avec une condition a été exécutée. Vous pouvez obtenir l’état de la condition dans chaque ligne.

Voir aussi :: Vue DATA_QUALITY_MONITORING_EXPECTATION_STATUS (vue LOCAL)

Syntaxe¶

DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
  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 avec une condition est définie. Le nom doit être entièrement qualifié.

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 avec une condition 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.

Sortie¶

La fonction renvoie des lignes avec 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 associée à la DMF.
`table_name`	VARCHAR	Nom de la table associée à la DMF.
`table_schema`	VARCHAR	Nom du schéma contenant la table associée à la DMF.
`table_database`	VARCHAR	Nom de la base de données contenant la table associée à la DMF.
`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. 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.
`expectation_name`	VARCHAR	Nom donné à la condition lorsqu’elle a été ajoutée à l’association entre la DMF et l’objet.
`expectation_id`	VARCHAR	Identificateur généré par le système.
`expectation_expression`	VARCHAR	Expression booléenne de la condition. Voir Définir ce qui répond à l’attente.
`expectation_violated`	BOOLEAN	Si TRUE, la condition n’a pas été respectée. Une condition est considérée comme non respectée lorsque l”`expectation_expression` renvoie la valeur FALSE. La valeur NULL indique que l’évaluation de la condition a échoué.

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.

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

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 spécifiés dans l’argument REF_ENTITY_DOMAIN, tels que 'STREAM', renvoient également des erreurs.

Exemples¶

Renvoie une ligne pour chaque fonction de métrique des données avec une condition affectée à la table nommée my_table :

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
    REF_ENTITY_NAME => 'my_db.sch1.my_table',
    REF_ENTITY_DOMAIN => 'TABLE'));

Copy